home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / vj_120.zip / MANUAL.DOC < prev    next >
Text File  |  1992-03-24  |  202KB  |  5,308 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                VEDIT Jr.
  7.  
  8.  
  9.  
  10.                       General Purpose Text Editor
  11.  
  12.                    One of the VEDIT Family of Editors
  13.  
  14.  
  15.                               Version 1.2
  16.  
  17.  
  18.                            Manual Written By:
  19.  
  20.                     Theodore Green and Charles Scott
  21.  
  22.  
  23.                              Programmed By:
  24.  
  25.                       Theodore Green & Thomas Burt
  26.  
  27.  
  28.  
  29.                           Greenview Data, Inc.
  30.                            2773 Holyoke Lane
  31.                           Ann Arbor, MI 48103
  32.  
  33.                        Telephone: (313) 996-1300
  34.                           Fax: (313) 996-1308
  35.                     BBS (2400 baud): (313)-996-1304
  36.                     BBS (9600 baud): (313)-996-1315
  37.  
  38.  
  39.  
  40. Copyright  (C)  1990-1991  by  Greenview Data, Inc.  All rights reserved
  41. worldwide.  No part of this publication may be reproduced, in  any  form
  42. or  by any means, for any purpose without the express written permission
  43. of Greenview Data. 
  44.  
  45.  
  46.                                DISCLAIMER
  47.  
  48. Greenview Data, Inc.  and the authors make no claims or warranties  with
  49. respect  to the contents or accuracy of this publication, or the product
  50. it describes, including any warranties of fitness or merchantability for
  51. a particular purpose.  Any stated or expressed warranties are in lieu of
  52. all obligations or liability for any damages, whether special, indirect,
  53. or consequential, arising out of or in connection with the use  of  this
  54. publication  or  the  product  it  describes.  Furthermore, the right is
  55. reserved to make any changes to this publication without  obligation  to
  56. notify any person of such changes. 
  57.  
  58.  
  59.  
  60.  
  61.                   Last Manual Revision: Mar. 30, 1992
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                                TRADEMARKS
  78.  
  79. VEDIT, V-SPELL and V-PRINT are trademarks of Greenview Data, Inc. 
  80.  
  81. MS-DOS, OS/2 and Xenix are trademarks of Microsoft. 
  82.  
  83. UNIX is a trademark of American Telephone & Telegraph. 
  84.  
  85. IBM and IBM PC are trademarks of International Business Machines. 
  86.  
  87. Ventura Publisher is a registered trademark of Ventura Software, Inc. 
  88.  
  89. WordStar is a registered trademark of MicroPro International Corp. 
  90.  
  91. Word Perfect is a trademark of WordPerfect Corp. 
  92.  
  93. Turbo Lightning and SuperKey are trademarks of Borland International. 
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                    2
  123.  
  124.  
  125. VEDIT Jr.                                              Table of Contents
  126.  
  127.  
  128. Table of Contents
  129. ------------------------------------------------------------------------
  130.  
  131. Chapter 1 - Introduction                                 5
  132.  
  133.         Welcome to VEDIT Jr.                             5
  134.         Main Features                                    6
  135.         VEDIT and VEDIT PLUS                             7
  136.         V-PRINT and V-SPELL                              8
  137.         System Requirements                             10
  138.         Using this Manual                               10
  139.         Notation                                        12
  140.  
  141. Chapter 2 - Getting Started                             15
  142.  
  143.         Installation                                    15
  144.             IBM PCDOS/MS-DOS Automated Installation     15
  145.             IBM PCDOS/MS-DOS Manual Installation        17
  146.             Checking Your CONFIG.SYS and AUTOEXEC.BAT   18
  147.                 PATH Command                            18
  148.                 VEDPATH Environment Variable            19
  149.             Testing Your Installation                   19
  150.         Getting Started Fast                            21
  151.             Running VEDIT Jr. with Floppy Disks         21
  152.             Description of Files on Disk                22
  153.         Keyboard Layout                                 23
  154.             Notes on Normal and Alternate Layout        24
  155.             "Normal" IBM PC Keyboard Layout             25
  156.  
  157. Chapter 3 - Quick Tutorial                              27
  158.         Starting VEDIT Jr.                              27
  159.         Entering New Text                               28
  160.         Moving the Cursor                               28
  161.         Deleting Text                                   29
  162.         Typing Beyond the Visible Screen Area           30
  163.         Line and Column Numbers                         31
  164.         Quick Cursor Movement                           31
  165.         Undo                                            33
  166.         Using Menus                                     34
  167.         Answering a Prompt                              35
  168.             Response History                            36
  169.         Exiting the Menu System                         37
  170.         Context Sensitive Help                          37
  171.             Keyboard Help                               38
  172.             General Help                                39
  173.         Printing Text                                   40
  174.         Repeating Operations                            41
  175.         Saving Your Work                                42
  176.         The "Escape" Menu                               42
  177.         Exiting VEDIT Jr.                               43
  178.  
  179. Chapter 4 - Editing Guide                               45
  180.  
  181.  
  182.  
  183.                                    3
  184.  
  185.  
  186. VEDIT Jr.                                              Table of Contents
  187.  
  188.  
  189.         Starting (Invoking) VEDIT Jr.                   45
  190.             Invocation Options                          45
  191.             "VEDIT" Environment Variable                47
  192.             Super-fast Browse Mode                      47
  193.         Exiting VEDIT Jr.                               48
  194.             Backup Files                                49
  195.         The Status Line                                 49
  196.         Using Menus                                     51
  197.         Responding to Prompts                           54
  198.         Point and Shoot File Selection                  55
  199.         On-Line Help                                    56
  200.             Modifying the Help File                     57
  201.         Mouse Support                                   58
  202.             Scroll Bars                                 59
  203.             "Stealth" Scroll Bars and the Right Button  60
  204.             Menu System                                 61
  205.             Block Operations                            61
  206.             Search/Replace Options                      62
  207.             Notes on Mouse Operation                    62
  208.         Screen Display & Keyboard Characters            62
  209.             Entering Control and Graphics Characters    63
  210.             How Control and Graphics Characters are
  211.               Displayed                                 63
  212.             Display Modes                               64
  213.             End of Line Handling (DOS and UNIX files)   64
  214.             The <Tab> Key and Tab Characters            65
  215.             Lower and Upper Case Conversion             66
  216.             Key Emulation Modes                         67
  217.             Other Keyboard Input Options (Technical)    68
  218.             Other Screen Display Issues (Technical)     68
  219.         Keystroke Macros                                69
  220.         Scrolling the Screen                            71
  221.             Vertical Scrolling                          71
  222.             Horizontal Scrolling                        71
  223.             Wrapping Long Lines on the Screen           72
  224.         Block Operations                                73
  225.             Marking (selecting) a Block of Text         73
  226.                 What exactly does the block include?    74
  227.             Copying/Moving Text Within Your File        74
  228.             [BLOCK COPY] and [BLOCK MOVE]               75
  229.             The Text Register                           75
  230.             Columnar Blocks                             76
  231.                 Columnar Block Examples                 76
  232.         Search and Replace                              80
  233.             Pattern Matching                            80
  234.         Word Procesing Functions                        83
  235.             Definition of "Word" and "Paragraph"        83
  236.             Indenting Text (Left Margin)                84
  237.             Word Wrap (Right Margin)                    85
  238.             Formatting and Justifying Paragraphs        85
  239.                 Offset Paragraphs                       86
  240.                 Justification                           87
  241.  
  242.  
  243.  
  244.                                    4
  245.  
  246.  
  247. VEDIT Jr.                      Chapter 1                    Introduction
  248.  
  249.  
  250. Chapter 1 - Introduction
  251. ------------------------------------------------------------------------
  252.  
  253.  
  254.                          Welcome to Vedit Jr.!
  255.                          ---------------------
  256.  
  257. Purpose of Program
  258. ------------------
  259.  
  260. VEDIT Jr. is   a   full   featured  text  editor  intended  for  program
  261. development, text preparation and the editing  of  any  text  or  binary
  262. files  you  will  ever  encounter.   It  is  ideal  for writing assembly
  263. language and structured programs (C, Pascal, PL/I) and lengthy documents
  264. such as reports  or  manuscripts.   It  is  also  well  suited  for  the
  265. preparation  of  text  files being used with Desktop Publishing packages
  266. such as Xerox's Ventura Publisher (tm). 
  267.  
  268.  
  269. Simple, Yet Powerful
  270. --------------------
  271.  
  272. VEDIT Jr. is simple enough to learn and use for the novice, yet has  the
  273. speed,  flexibility  and  power  to  satisfy the most demanding computer
  274. professional.  It offers a  rich  assortment  of  editing  capabilities,
  275. simple menu operation, complete on-line help facilities, and the ability
  276. to edit text and binary files of any size (even 100 Megabyte or larger).
  277.  
  278.  
  279. Totally Configurable
  280. --------------------
  281.  
  282. The  comprehensive  configuration lets you completely determine your own
  283. keyboard layout  and  select  numerous  default  settings  to  configure
  284. VEDIT Jr. to   your   particular  hardware,  applications  and  personal
  285. preferences.  By using the  available  options  and  "keystroke  macros"
  286. VEDIT Jr. can very closely emulate other editors and word processors. 
  287.  
  288. An easy to use installation program for the IBM PC permits a quick, menu
  289. driven  selection  of  the most common configurations of VEDIT Jr.  This
  290. includes selecting from the normal keyboard layout (used in this manual)
  291. or from a WordStar or Word Perfect layout. 
  292.  
  293.  
  294. VEDIT Family of Editors
  295. -----------------------
  296.  
  297. VEDIT Jr. is one of the VEDIT Family  of  Editors  which  also  includes
  298. VEDIT and VEDIT PLUS.  The VEDIT family is available for virtually every
  299. computer  running  under the PCDOS, MS-DOS (IBM and non-IBM compatible),
  300. UNIX 286/386/486, XENIX,  QNX,  Concurrent  DOS,  FlexOS  and  IBM  4680
  301. operating  systems.   Attractive  pricing  is  available  for additional
  302. machines and for educational, OEM and site licensing. 
  303.  
  304.  
  305.                                    5
  306.  
  307.  
  308. VEDIT Jr.                      Chapter 1                    Introduction
  309.  
  310.  
  311.                              Main Features
  312.                              -------------
  313.  
  314. *  Edit any text or binary files of  up  to  2  Gigabytes  (that's  2000
  315.    megabytes).   Virtual  file  buffering  automatically  handles  files
  316.    larger than what will fit into memory. 
  317.  
  318. *  Pull-down menu  system.   Easy  access  to  most  editing  functions.
  319.    Editing  functions can also be quickly accessed with "hot keys" which
  320.    bypass the menu  system  --  the  menu  system  does  not  slow  down
  321.    proficient users. 
  322.  
  323. *  Unlimited  keystroke  macros.   Any  combination of keystrokes can be
  324.    assigned to a single key.  Allows single key access to menu functions
  325.    and creation of custom editing functions.  Keystroke  macros  may  be
  326.    built into VEDIT Jr., saved to and loaded from disk. 
  327.  
  328. *  Context  sensitive  help.   Pressing the help key gives you precisely
  329.    the information you need at  the  moment.   The  help  text  is  user
  330.    changeable  and  expandable.  Add your own help prompts and messages,
  331.    even create on-line help for other programs you use. 
  332.  
  333. *  Multi-level Undo.  Up to hundreds of the most recent edit changes can
  334.    be reversed either step by step or line by line.  Deleted text can be
  335.    re-inserted in its original position or anywhere else. 
  336.  
  337. *  Automatic  indenting  simplifies  editing  of  structured   programs;
  338.    advantageous  for  word  processing.   Check  for  proper  nesting of
  339.    parentheses, e.g. "{" and "}", aids C programming. 
  340.  
  341. *  Execute single DOS commands (DIR, compilers, V-SPELL, etc.) or  enter
  342.    DOS and return later. 
  343.  
  344. *  Flexible  block  operations  can process text on a character, line or
  345.    column basis.  Blocks may be moved or  copied  directly,  or  a  text
  346.    register  (scratch-pad buffer) may be used for more flexible "cut and
  347.    paste" operations.  Blocks can be copied from one file to another. 
  348.  
  349. *  Powerful  search  and  replace.    Supports   sophisticated   pattern
  350.    matching,  reverse searching, selective and global replace.  Previous
  351.    search strings can be quickly accessed. 
  352.  
  353. *  Flexible printing with variable margins and page size.  Print a block
  354.    of text or the entire file with single,  double  or  triple  spacing.
  355.    V-PRINT, a powerful print formatter is available. 
  356.  
  357. *  ASCII  table.   Pop up the ASCII table or insert any desired control,
  358.    printer or graphic character into  the  text.   IBM  PC  box  drawing
  359.    characters are easily accessed. 
  360.  
  361. *  Horizontal  scrolling for editing long lines -- spreadsheets, program
  362.    listings.  Optionally, long lines can be wrapped onto multiple screen
  363.    lines. 
  364.  
  365.  
  366.                                    6
  367.  
  368.  
  369. VEDIT Jr.                      Chapter 1                    Introduction
  370.  
  371.  
  372.  
  373. *  Fully adjustable tab positions.   The  <Tab>  key  can  enter  a  tab
  374.    character or, optionally, spaces to the next tab position. 
  375.  
  376. *  Word  processing.  Word wrap, paragraph formatting between adjustable
  377.    margins, optional  justification,  printing.   (Does  NOT  enter  any
  378.    "special"  control  character into the text.) Can read/write WordStar
  379.    compatible files.  V-SPELL, a high performance spelling corrector  is
  380.    available. 
  381.  
  382. *  Word   processor  emulation.   VEDIT Jr. can  closely  emulate  other
  383.    editors and word processors.  Contains options for  emulating  common
  384.    cursor  positioning  modes, other block operations, various styles of
  385.    searching, functions performed by the <Tab> and <Enter> keys and much
  386.    more. 
  387.  
  388. *  Totally configurable.  The keyboard layout is completely configurable
  389.    -- assign any key to any function.  Any desired number  of  keystroke
  390.    macros   can   be  built  in.   Default  settings  of  all  switches,
  391.    parameters,  options   and   screen   colors   can   be   configured.
  392.    Configurable  tab-fill  and  "newline"  display characters.  Provides
  393.    selectable hardware/software cursor, cursor blink rate (or no  blink)
  394.    and much more. 
  395.  
  396.  
  397.                           VEDIT and VEDIT PLUS
  398.                           --------------------
  399.  
  400. VEDIT and VEDIT PLUS are upwards compatible from VEDIT Jr. and have many
  401. additional  features.   Should your editing needs outgrow VEDIT Jr., you
  402. can easily move to VEDIT or VEDIT PLUS. 
  403.  
  404. Your $29 registration fee for VEDIT Jr. may be applied to your  purchase
  405. of  VEDIT  or  VEDIT PLUS when you purchase directly from Greenview Data
  406. and your purchase is made within six (6) months. 
  407.  
  408. The additional features in VEDIT include:
  409.  
  410. *  Multiple file editing.  Simultaneously edit up to 37 files,  each  of
  411.    any size. 
  412.  
  413. *  Flexible  windowing.  Optionally display each file you are editing in
  414.    its own variable sized window.  Different parts of one  file  can  be
  415.    displayed  in  separate  windows.   Any  window can be zoomed to full
  416.    screen. 
  417.  
  418. *  Hexadecimal and  EBCDIC  editing.   Any  window  can  be  toggled  to
  419.    different modes for editing in ASCII, EBCDIC or Hexadecimal.  A split
  420.    screen with simultaneous editing in different modes is also possible.
  421.  
  422. *  Integrated compiler support.  Popular compilers, assemblers, linkers,
  423.    debuggers and Make programs can be run from within VEDIT.  The cursor
  424.    will  be  automatically  positioned  on  source code lines containing
  425.  
  426.  
  427.                                    7
  428.  
  429.  
  430. VEDIT Jr.                      Chapter 1                    Introduction
  431.  
  432.  
  433.    compilation errors.  Very flexible and configurable;  easily  support
  434.    new/custom compilers. 
  435.  
  436. *  Search/replace  with  regular  expressions.  A full implementation of
  437.    Unix style regular expressions permits more sophisticated search  and
  438.    replace operations. 
  439.  
  440. VEDIT  PLUS  has  all  the  features  of VEDIT and adds a powerful macro
  441. programming language:
  442.  
  443. *  Over 150 commands.  Commands  can  be  combined  to  create  powerful
  444.    "macros"   which   save   you  time  by  automating  complex  editing
  445.    operations.  Macros can be saved to disk and loaded from disk. 
  446.  
  447. *  Complete  macro  programming  language  with  looping,  Repeat-Until,
  448.    If-Then,  If-Then-Else,  conditional  Jump.   Numeric,  character and
  449.    string testing. 
  450.  
  451. *  Auto-execution.  A file containing macro commands  can  be  specified
  452.    for automatic execution when VEDIT PLUS is invoked. 
  453.  
  454. *  Complete numerical capability with 24 bit resolution (+/- 8,388,607).
  455.    100  "variables",  expression  evaluation with numerical, logical and
  456.    relational functions.  On-line algebraic calculator. 
  457.  
  458. *  Interactive input and output with complete screen and window control.
  459.    Creating, deleting, size, position and  color  of  windows  is  fully
  460.    programmable. 
  461.  
  462. *  (DOS  only) Access to hardware.  Memory and I/O ports can be examined
  463.    and modified.  DOS functions, BIOS functions and  interrupts  can  be
  464.    directly called. 
  465.  
  466.  
  467.                           V-PRINT and V-SPELL
  468.                           -------------------
  469.  
  470. V-PRINT  and  V-SPELL  work  with  VEDIT Jr. to give you a complete word
  471. processing system.  Both V-PRINT and V-SPELL  can  be  run  from  within
  472. VEDIT Jr. with  a single keystroke, letting you instantly print or spell
  473. check the current document. 
  474.  
  475.  
  476. V-PRINT Document Formatter
  477. --------------------------
  478.  
  479. V-PRINT is a  powerful  document  (text)  formatter  which  handles  the
  480. details  of  page  layout,  including  headers,  footers, automatic page
  481. numbering, indenting and justification. 
  482.  
  483. V-PRINT not only handles the  details  of  page  layout,  but  also  has
  484. facilities  for  automatic  index  and  table  of  contents  generation,
  485. underlining, overstriking, multiple font support  for  popular  printers
  486.  
  487.  
  488.                                    8
  489.  
  490.  
  491. VEDIT Jr.                      Chapter 1                    Introduction
  492.  
  493.  
  494. and much more.  Multiple files can be included in your document at print
  495. time  with  an "Include" statement.  Single sheets, continuous forms and
  496. any selected page range can be printed. 
  497.  
  498. Combining VEDIT Jr. with V-PRINT gives you the capabilities  of  a  full
  499. featured  word processor.  Both are particularly well suited to handling
  500. long documents such as reports, manuals and manuscripts. 
  501.  
  502. A table of contents and index can be generated by  V-PRINT.   The  index
  503. can contain both words which appear in the text and "concepts" which are
  504. not  explicitly mentioned in the text.  V-PRINT also allows the Table of
  505. Contents and the Index to be edited before final printing.   List  price
  506. $79. 
  507.  
  508.  
  509. V-SPELL Spelling Corrector
  510. --------------------------
  511.  
  512. This  is  the  ultimate spelling corrector that proofreads 50 pages (100
  513. Kbytes) of text in 30 seconds (on an  IBM  PC/AT),  displays  misspelled
  514. words   in  context  and  can  instantly  suggest  corrections  for  any
  515. misspelling.  Since it automatically corrects the words in the document,
  516. there is no need to go back to the word processor.  The 70,000 word main
  517. dictionary  is  expandable--you   can   have   your   own   supplemental
  518. dictionaries  and/or  merge them into the main dictionary.  You can even
  519. create your own main dictionary.  Not only VEDIT Jr., but  most  popular
  520. word processors are supported. 
  521.  
  522. For  typesetting, desktop publishing and other applications, V-SPELL can
  523. perform file hyphenation by inserting "soft hyphens" in all words  of  a
  524. document.   Since  the hyphenation points are built into the dictionary,
  525. you can be sure it is 100% correct  --  no  error-prone  algorithms  are
  526. used!  List price $79. 
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                                    9
  550.  
  551.  
  552. VEDIT Jr.                      Chapter 1                    Introduction
  553.  
  554.  
  555.                           System Requirements
  556.                           -------------------
  557.  
  558. The DOS version requires:
  559.  
  560. *  MS-DOS  or PCDOS version 2.0 or later, or a compatible DOS such as DR
  561.    DOS or Concurrent DOS.   DesqView  and  Microsoft  Windows  are  also
  562.    supported. 
  563.  
  564. *  An  IBM  PC,  XT,  AT,  PS/2  or  compatible  computer.   Some "near"
  565.    compatibles such as the Tandy 2000 and Sanyo 550 are also supported. 
  566.  
  567. *  At least 196 Kbytes of memory.  (At least 100K of memory must be free
  568.    after DOS is loaded.)
  569.  
  570. *  A hard disk is highly recommended, but VEDIT Jr. can be installed on,
  571.    and will run from, a floppy disk.  A minimum of 64K for the VJ.EXE is
  572.    required, the optional 60K help file is highly recommended. 
  573.  
  574. *  A monochrome, CGA, MCGA, EGA, VGA or compatible display  adapter  and
  575.    display.   The  Amdec  1280 and Wyse 700 displays are also supported.
  576.    EGA 43 line and VGA 50 line modes are supported. 
  577.  
  578.  
  579.                            Using this Manual
  580.                            -----------------
  581.  
  582. HINTS:  The best  way  to  learn  VEDIT Jr. is  by  running  the  "Demo/
  583.         Tutorial"  disk  supplied  for DOS.  This disk covers VEDIT Jr.,
  584.         VEDIT, and VEDIT PLUS features in great  depth  --  it  is  well
  585.         worth  the  one  or  two  hours  it  will take to carefully work
  586.         through it. 
  587.  
  588.         Between  the  "Demo/Tutorial"  disk  and  VEDIT Jr.'s  extensive
  589.         on-line help, we hope that you won't need this manual very much.
  590.  
  591.  
  592. Organization
  593. ------------
  594.  
  595. ***************************************************************
  596. *                                                             *
  597. *  This on-disk file consists of the first four chapters of   *
  598. *  the manual.  The entire manual is summarized below.        *
  599. *                                                             *
  600. ***************************************************************
  601.  
  602. This  manual  assumes that you have a working knowledge of your computer
  603. and its basic operation.  It is organized into the following chapters:
  604.  
  605. *  Introduction (Chapter 1)
  606.      Introduces  VEDIT Jr. and  lists  the  main  features  and   system
  607.      requirements. 
  608.  
  609.  
  610.                                    10
  611.  
  612.  
  613. VEDIT Jr.                      Chapter 1                    Introduction
  614.  
  615.  
  616.  
  617. *  Getting Started (Chapter 2)
  618.      Explains  how to install VEDIT Jr. and make sure that it is working
  619.      correctly.  It lists the files on disk and  the  "Normal"  keyboard
  620.      layout. 
  621.  
  622. *  Quick Tutorial (Chapter 3)
  623.      This  short  tutorial  familiarizes  you  with the basic aspects of
  624.      using VEDIT Jr. including the menu system,  on-line  help,  how  to
  625.      save your result and exit VEDIT Jr. 
  626.  
  627. *  Editing Guide (Chapter 4)
  628.      Covers the main topics of how to use VEDIT Jr. in general terms. 
  629.  
  630. *  Command Macros (Chapter 5)
  631.      Describes  how to use the "command macros" supplied only with VEDIT
  632.      and VEDIT PLUS.  In  particular,  the  compiler  support  macro  is
  633.      covered in great detail. 
  634.  
  635. *  Menu Reference (Chapter 6)
  636.      Describes each item in the Menu system in detail.  It includes many
  637.      step by step directions for using the features of VEDIT Jr. 
  638.      
  639.      The  {CONFIG}  menu described here lets you configure VEDIT Jr. and
  640.      fine-tune it to your personal preferences and applications. 
  641.  
  642. *  Edit Function Reference (Chapter 7)
  643.      Describes each basic edit function in detail. 
  644.  
  645. *  Configuration (Chapter 8)
  646.      For the most part, you can configure VEDIT Jr. from within  itself.
  647.      However,  some  additional,  mostly  hardware related configuration
  648.      changes can only  be  made  with  the  VCONFIG  program  or  ".CFG"
  649.      configuration files described in this chapter. 
  650.  
  651. *  Messages (Chapter 9)
  652.      Lists   and  explains  all  error  messages  and  common  prompting
  653.      messages. 
  654.  
  655. *  Appendices
  656.      The following topics are included in the appendices:
  657.      
  658.      Technical  descriptions  of  VEDIT Jr.'s  file  handling,   network
  659.      support and memory management. 
  660.      
  661.      Installation  and  usage  of  V-SWAP  (supplied only with VEDIT and
  662.      VEDIT PLUS). 
  663.      
  664.      Additional keyboard layout information. 
  665.      
  666.      Application Notes. 
  667.      
  668.      ASCII Table. 
  669.  
  670.  
  671.                                    11
  672.  
  673.  
  674. VEDIT Jr.                      Chapter 1                    Introduction
  675.  
  676.  
  677. Notation
  678. --------
  679.  
  680. <Ctrl-x>             A control character, such  as  <Ctrl-U>,  which  is
  681.                      typed  by holding down the "Ctrl" (Control) key and
  682.                      typing the specified letter. 
  683.  
  684. <Alt-x>              A control character,  such  as  <Alt-E>,  which  is
  685.                      typed by holding down the "Alt" (Alternate) key and
  686.                      typing the specified letter. 
  687.  
  688. <Backspace>          The  "Backspace"  key.   Also  named  "BS"  on some
  689.                      keyboards. 
  690.  
  691. <Alt-Bksp>           This is an abbreviation for <Alt-Backspace>.  Other
  692.                      abbreviations   used   are   <Ctrl-Backspace>   and
  693.                      <Shft-Backspace>. 
  694.  
  695. <Enter>              The  "Enter"  key.   Also named "Return" or "CR" on
  696.                      some keyboards. 
  697.  
  698. <key>                Any other individual key such as <Esc>, <Space bar>
  699.                      or <Tab>. 
  700.  
  701. <F1>                 The default  key  for  the  [HELP]  function.   The
  702.                      actual key is displayed on the status line. 
  703.  
  704. <F10>                The default key for accessing the main menu. 
  705.  
  706. [function]           A  basic  editing  function  such as [CURSOR UP] or
  707.                      [INDENT].   Each  edit  function  name  is  usually
  708.                      followed  with  the  keypress  corresponding to the
  709.                      "normal" keyboard layout.  However, you are free to
  710.                      modify  the  keyboard  layout.   The   actual   key
  711.                      assignments are displayed by the [HELP] function. 
  712.  
  713. {menu, menu-item}-x  Menu  selections are shown within braces optionally
  714.                      followed by "x" to  indicate  variable  parameters.
  715.                      The  main menu is selected with the [MENU] function
  716.                      (<F10>).  For example,  {GOTO, Line #}  71  denotes
  717.                      that  you  select "Goto" from the main menu, select
  718.                      "Line #" from the "Goto" menu, and then  enter  the
  719.                      value "71" at the line number prompt. 
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                                    12
  733.  
  734.  
  735. VEDIT Jr.                      Chapter 1                    Introduction
  736.  
  737.  
  738. Register Today! 
  739. ---------------
  740.  
  741. One  benefit in registering VEDIT Jr. (for only $29) is the professional
  742. quality manual whose  more  than  200  pages  describe  the  program  in
  743. complete detail. 
  744.  
  745. You  will  also receive the latest production version of VEDIT Jr. which
  746. does not have the Shareware sign-on screens. 
  747.  
  748. We welcome your comments and suggestions. 
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                    13
  794.  
  795.  
  796. VEDIT Jr.                      Chapter 1                    Introduction
  797.  
  798.  
  799.                     This page is intentionally blank
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                    14
  855.  
  856.  
  857. VEDIT Jr.                      Chapter 2                 Getting Started
  858.  
  859.  
  860. Chapter 2 - Getting Started
  861. ------------------------------------------------------------------------
  862.  
  863.  
  864.                               Installation
  865.                               ------------
  866.  
  867. NOTES: Be  sure  to  refer  to  the  file  "README"  before   installing
  868.        VEDIT Jr. --  simply  give  the  DOS command "README".  This file
  869.        often contains last minute installation instructions. 
  870.  
  871.        Refer to Appendix F (Troubleshooting) if  you  have  any  trouble
  872.        installing  or  running  VEDIT Jr.   (Not  included  with on-disk
  873.        doco.)
  874.        
  875.        When we refer to "IBM PCDOS/MS-DOS" we mean all IBM  PC/AT,  PS/2
  876.        machines  or  compatibles,  including  all clones, running either
  877.        PCDOS or MS-DOS  2.x,  3.x,  4.x,  5.x  or  compatible  operating
  878.        systems including Concurrent DOS and DR DOS. 
  879.  
  880.  
  881. IBM PCDOS/MS-DOS Automated Installation
  882. ---------------------------------------
  883.  
  884. The  IBM  PCDOS/MS-DOS version of VEDIT Jr. can be quickly installed and
  885. configured with the supplied INSTALL program.  It creates the  directory
  886. "\VEDIT"  (on  a hard disk), copies the appropriate files to it and lets
  887. you select from the most common configuration options including  display
  888. type, screen color and the initial keyboard layout.  There is NO NEED to
  889. initially run the configuration program VCONFIG. 
  890.  
  891. NOTES: This   automated   installation   is  NOT  compatible  with  some
  892.        memory-resident programs and,  in  particular,  with  the  Norton
  893.        Commander   Commander(tm),  4DOS  and  other  "point  and  shoot"
  894.        programs.   You  must  remove  such  programs  to   perform   the
  895.        installation  or  follow  the  "Manual  Installation" directions.
  896.        However, once installed, VEDIT Jr. itself  will  run  with  these
  897.        programs. 
  898.  
  899.        The  automated  installation  DOES  NOT  alter your CONFIG.SYS or
  900.        AUTOEXEC.BAT files!  It creates the  directory  "\VEDIT",  copies
  901.        files to it and pre-configures VJ.EXE. 
  902.        
  903.        Before  actually  installing VEDIT Jr., you should make a copy of
  904.        the original VEDIT Jr. disk and place  the  original  in  a  safe
  905.        place.   Install  VEDIT Jr. from this copy to prevent inadvertent
  906.        damage to the original  diskette.   Refer  to  the  documentation
  907.        provided  with  your  operating  system for information on how to
  908.        copy diskettes. 
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.                                    15
  916.  
  917.  
  918. VEDIT Jr.                      Chapter 2                 Getting Started
  919.  
  920.  
  921. To install VEDIT Jr. on a floppy disk:
  922.  
  923.     1.  You will need a blank, formatted floppy disk on which to install
  924.         VEDIT Jr.  Refer to the  documentation  provided  with  DOS  for
  925.         information on how to format diskettes. 
  926.  
  927.     2.  Place  a  copy of the VEDIT Jr. distribution diskette into drive
  928.         A: and a blank, formatted diskette into drive B: then type:
  929.  
  930.            A: <Enter>
  931.  
  932.     3.  Start the installation program by typing:
  933.  
  934.            INSTALL A B <Enter>
  935.  
  936.     4.  Follow the instructions provided by  the  installation  program.
  937.         The  installation  program  will  ask several questions.  Answer
  938.         these questions by pressing the appropriate letter key.  You  do
  939.         not have to press <Enter>. 
  940.  
  941. To install VEDIT Jr. on a hard disk:
  942.  
  943.     1.  Place   a  copy  of  the  VEDIT Jr. distribution  diskette  into
  944.         drive A: and type:
  945.  
  946.             A: <Enter>
  947.  
  948.     2.  Start the installation program by typing:
  949.  
  950.             INSTALL A C <Enter>
  951.  
  952.         This command will install VEDIT Jr. from the diskette  in  drive
  953.         A:  to  the  directory  "\VEDIT"  on  drive  C:.  If you want to
  954.         install on a drive other than C:,  substitute  the  "C"  in  the
  955.         above command with the appropriate drive letter. 
  956.  
  957.     3.  Follow  the  instructions  provided by the installation program.
  958.         The installation program will  ask  several  questions.   Answer
  959.         these  questions by pressing the appropriate letter key.  You do
  960.         not have to press <Enter>. 
  961.  
  962. The  tutorials  in  this  manual  show   examples   for   the   "Normal"
  963. (recommended) keyboard layout only.  While VEDIT Jr. may be installed to
  964. mimic  Wordstar  or  WordPerfect, it is suggested that you first try our
  965. normal configuration. 
  966.  
  967. When complete, you will have  a  ready  to  use  "VJ.EXE"  file  in  the
  968. directory "\VEDIT". 
  969.  
  970. NOTE:  Skip  down  several  pages to the topic "Checking Your CONFIG.SYS
  971.        and  AUTOEXEC.BAT  files"  for  further  important   installation
  972.        instructions. 
  973.  
  974.  
  975.  
  976.                                    16
  977.  
  978.  
  979. VEDIT Jr.                      Chapter 2                 Getting Started
  980.  
  981.  
  982.        Then refer to the topic "Testing your Installation" below. 
  983.  
  984.  
  985. IBM PCDOS/MS-DOS Manual Installation
  986. ------------------------------------
  987.  
  988. This  topic  covers  the  steps  needed  to  install  VEDIT Jr. when the
  989. automated installation will not run on your system. 
  990.  
  991. The only file absolutely needed to use VEDIT Jr. is  VJ.EXE.   (You  can
  992. rename  it  if  you  wish.)  To  use  the on-line help you also need the
  993. VJHELP.HLP file.  VEDIT Jr. can be configured to  search  for  its  help
  994. file   in   the  root  directory  or  "VEDIT Home Directory",  typically
  995. "\VEDIT", of any drive you select. 
  996.  
  997. Decide upon the name of a new directory  to  hold  all  VEDIT Jr. files.
  998. This  manual  assumes  it  is "\VEDIT" on any desired drive.  Create the
  999. directory.  When installing VEDIT Jr. on a floppy disk, you can  install
  1000. it into the root directory. 
  1001.  
  1002. After  you  create "\VEDIT", you should copy all files from the original
  1003. disk or disks to this directory.  This chapter lists the files found  on
  1004. the VEDIT Jr. distribution disk(s). 
  1005.  
  1006. The  supplied  VJ.EXE  will  immediately  run on any machine, but is not
  1007. configured ideally for either floppy or hard  disk  systems.   You  only
  1008. need  to change the configuration parameters 1.0 and 2.3 (see Chapter 8)
  1009. to adapt VEDIT Jr. to your particular disk  configuration.   Unless  you
  1010. configure  it,  VEDIT Jr. only  searches the current drive and directory
  1011. for its help file. 
  1012.  
  1013. With a  hard  disk,  you  should  configure  VCONFIG  parameter  1.0  to
  1014. "C:\VEDIT\"  and  2.3 to "0" -- assuming you are installing VEDIT Jr. in
  1015. "\VEDIT" on drive "C:". 
  1016.  
  1017. With a floppy disk based system, you may want to copy  only  the  VJ.EXE
  1018. and  VJHELP.HLP  files  to  your system disk on drive A.  Then configure
  1019. VJ.EXE with VCONFIG parameter 1.0 set to "A:\" and 2.3 set to "0". 
  1020.  
  1021. Refer above to the topic "IBM PCDOS/MS-DOS Automated  Installation"  for
  1022. information about setting up your PATH command and AUTOEXEC.BAT files. 
  1023.  
  1024. Here is a typical installation:
  1025.  
  1026.  
  1027.     1.  Make  sure  you  are  in the root directory of drive C.  Put the
  1028.         original VEDIT Jr. diskette into drive A.   Give  the  following
  1029.         DOS commands:
  1030.  
  1031.             MD C:\VEDIT
  1032.             CD C:\VEDIT
  1033.             COPY A:*.*
  1034.  
  1035.  
  1036.  
  1037.                                    17
  1038.  
  1039.  
  1040. VEDIT Jr.                      Chapter 2                 Getting Started
  1041.  
  1042.  
  1043.     2.  Start up the configuration program with the command:
  1044.  
  1045.             VCONFIG VJ.EXE
  1046.  
  1047.     Refer  to  Chapter  8 (Configuration) for details about running this
  1048.     program. 
  1049.  
  1050. 3.  In the configuration program select "1" from the main menu and enter
  1051.     a "VEDIT Jr. Home Directory" of "C:\VEDIT\".  Then select  parameter
  1052.     2.2 and change it to "0". 
  1053.  
  1054. 4.  Press  <Enter>  to  return  to  the main menu.  Type "E" to exit the
  1055.     configuration program.  At the confirmation prompt type "Y" to  save
  1056.     your changes. 
  1057.  
  1058. NOTE:  Skip  down  several  pages to the topic "Checking Your CONFIG.SYS
  1059.        and  AUTOEXEC.BAT  files"  for  further  important   installation
  1060.        instructions. 
  1061.  
  1062.        Then refer to the topic "Testing your Installation" below. 
  1063.  
  1064.  
  1065. Checking Your CONFIG.SYS and AUTOEXEC.BAT files
  1066. -----------------------------------------------
  1067.  
  1068. You should check the file "CONFIG.SYS" which is in the root directory of
  1069. your hard (boot) disk.  It must contain the two lines:
  1070.  
  1071.             BUFFERS=10
  1072.             FILES=40
  1073.  
  1074. ***It is OK if the numbers are larger than those listed above!***
  1075.  
  1076. If  you  discover that you do not have a CONFIG.SYS file, you can create
  1077. one using VEDIT Jr.  You can do this after completing the Quick Tutorial
  1078. in Chapter 3.  CONFIG.SYS is a normal text file. 
  1079.  
  1080. The "BUFFERS=10" statement is not really necessary  but  speeds  up  not
  1081. only VEDIT Jr. but virtually every other program.  No computer should be
  1082. without  it.   "BUFFERS=15"  or  "BUFFERS=20"  may further speed up some
  1083. programs, but also make DOS use up more memory space. 
  1084.  
  1085.  
  1086. PATH Command
  1087. ------------
  1088.  
  1089. To run VEDIT Jr. from other drives and directories, DOS must know  where
  1090. to  find  VJ.EXE.   Our  recommendation  is  to  simply copy VJ.EXE to a
  1091. directory, typically "\DOS" or "\BIN", which DOS  already  searches  for
  1092. other  programs such as CHKDSK.COM, FORMAT.COM, etc.  Alternatively, you
  1093. can add the directory "\VEDIT" to the PATH command in your  AUTOEXEC.BAT
  1094. file.   However,  long  PATH commands slow down computer operation.  For
  1095. more information on PATH and AUTOEXEC.BAT refer to your DOS manual. 
  1096.  
  1097.  
  1098.                                    18
  1099.  
  1100.  
  1101. VEDIT Jr.                      Chapter 2                 Getting Started
  1102.  
  1103.  
  1104.  
  1105. If you prefer not to have VEDIT Jr. in the  default  directory  "\VEDIT"
  1106. you  can  create  the  desired  directory  and  copy  all files from the
  1107. "\VEDIT" directory to it; then remove the "\VEDIT" directory.  Then  run
  1108. the  configuration  program  VCONFIG  (Chapter  8) and set parameter 1.0
  1109. (VEDIT Jr.   Home   Directory)   to   the   directory   in   which   the
  1110. VEDIT Jr. files reside. 
  1111.  
  1112.  
  1113. "VEDPATH" Environment Variable
  1114. ------------------------------
  1115.  
  1116. As  an alternative to running VCONFIG to set the "VEDIT Home Directory",
  1117. you can set the environment variable "VEDPATH" to the desired directory.
  1118. When this environment variable is set, it  overrides  any  configuration
  1119. setting. 
  1120.  
  1121. For  example,  if  you  placed  the  VEDIT Jr. files  in  the  directory
  1122. "\DOS\VEDIT" on drive "C:", you could add the  following  line  to  your
  1123. AUTOEXEC.BAT file:
  1124.  
  1125.         SET VEDPATH=C:\DOS\VEDIT
  1126.  
  1127.  
  1128. Testing Your Installation
  1129. -------------------------
  1130.  
  1131. Now  that  you have VEDIT installed, let's start it up once just to make
  1132. sure that everything is working. 
  1133.  
  1134.     1.  Assuming  that  your  PATH  command   includes   the   directory
  1135.         containing the VEDIT Jr. program, you can can start up VEDIT Jr.
  1136.         from any directory by typing:
  1137.  
  1138.             VEDIT <Enter>
  1139.  
  1140.         If  VEDIT Jr. was  properly  installed,  there  will  be a short
  1141.         pause, and you will see the VEDIT Jr.'s signon  message  on  the
  1142.         top  of  the  screen.   There should also be a (flashing) cursor
  1143.         near the upper-left corner of the screen. 
  1144.  
  1145.     2.  Press the <Esc> key to bring up the "Escape" menu in the  middle
  1146.         of the screen. 
  1147.  
  1148.         If you cannot read the menu, cannot tell which item is currently
  1149.         selected,   or   cannot  tell  which  letter  in  each  item  is
  1150.         highlighted, your screen attributes are not set  correctly.   If
  1151.         you  have  a  monochrome  (black  and white) monitor or a laptop
  1152.         computer you may need to re-install VEDIT Jr. for  a  monochrome
  1153.         monitor  or start up VEDIT Jr. with the "-M" option.  Otherwise,
  1154.         see "Change Screen Parameters" in Chapter 8  (Configuration)  on
  1155.         how to change screen attributes. 
  1156.  
  1157.  
  1158.  
  1159.                                    19
  1160.  
  1161.  
  1162. VEDIT Jr.                      Chapter 2                 Getting Started
  1163.  
  1164.  
  1165.     3.  To exit VEDIT Jr. and return to DOS using the displayed {ESCAPE}
  1166.         menu,  press  <Cursor  Down> to highlight "Quit File (Abandon)";
  1167.         then press <Enter>.  At the confirmation prompt "Abandon altered
  1168.         file (Y/N)" type "Y".  You should now be back in DOS. 
  1169.  
  1170.  
  1171.   NEWS.TXT        LINE:    1   COL:   1                 INS             F1=HELP
  1172. ╒═════════════════════════════════════════════════════════════════════════════╕
  1173. │▓                                                                            │
  1174. │                                                                             │
  1175. │                        ╒══════════════════════╕                             │
  1176. │                        │     ESCAPE MENU      │                             │
  1177. │                        │ Remove Block Markers │                             │
  1178. │                        │ Exit file            │                             │
  1179. │                        ╘══════════════════════╛                             │
  1180. │                                                                             │
  1181. │                                                                             │
  1182. ╘═════════════════════════════════════════════════════════════════════════════╛
  1183.  
  1184.  
  1185. VEDIT Jr. is  now  installed  and   tested.    Refer   to   Appendix   F
  1186. (Troubleshooting) if you encounter any trouble running VEDIT Jr. 
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.                                    20
  1221.  
  1222.  
  1223. VEDIT Jr.                      Chapter 2                 Getting Started
  1224.  
  1225.  
  1226.                           Getting Started Fast
  1227.                           --------------------
  1228.  
  1229. Despite  the  many pages in this manual, basic editing with VEDIT Jr. is
  1230. very intuitive and you can start using it immediately, without having to
  1231. study this manual. 
  1232.  
  1233. It is easiest to start the editor by specifying the name of the file you
  1234. want to edit:
  1235.  
  1236.         VJ filename.ext
  1237.  
  1238. For help while editing press the [HELP] key.  The name of the  help  key
  1239. is  displayed on the status line (default: <F1>).  [HELP] first displays
  1240. the key assignments for all of VEDIT Jr.'s functions.  For more help  on
  1241. any function, just press the corresponding key. 
  1242.  
  1243. The [MENU] key (default: <F1>) starts the pull-down menu system.  Select
  1244. the desired function using the cursor keys and then press <Enter>. 
  1245.  
  1246. To finish editing, access the "File" sub-menu and select "Exit".  If you
  1247. have  altered  the  file, it will prompt you whether you want to save or
  1248. abandon your changes. 
  1249.  
  1250. NOTE:  The quickest way  to  learn  VEDIT Jr. is  to  run  the  supplied
  1251.        "DEMO/TUTORIAL"  disk  which covers almost everything you need to
  1252.        know to effectively use VEDIT Jr. 
  1253.  
  1254.  
  1255. Running VEDIT Jr. with Floppy Disks
  1256. -----------------------------------
  1257.  
  1258. To run VEDIT Jr. with dual floppy disks (no hard disk)  place  the  disk
  1259. containing  the  installed  VEDIT Jr. into  drive  "A:",  the  data disk
  1260. containing your text files into drive "B",  change  to  drive  "B:"  and
  1261. specify the name of the file you want to edit:
  1262.  
  1263.         A:VJ filename.ext
  1264.  
  1265. Remember:  To  edit any file, the amount of free space on your disk must
  1266.            be at least as large as the file you want to edit. 
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.                                    21
  1282.  
  1283.  
  1284. VEDIT Jr.                      Chapter 2                 Getting Started
  1285.  
  1286.  
  1287. Description of Files on Disk
  1288. ----------------------------
  1289.  
  1290. README.BAT      Last minute notes to read before getting started.
  1291.  
  1292. INSTALL.BAT     Batch file to start up the automated installation;
  1293.                 it uses the files INSTALL.VBT and VBATCH.COM.
  1294.  
  1295. INSTALL.VBT     Script file for automated installation.
  1296.  
  1297. VBATCH.COM      Installation program used for automated installation.
  1298.  
  1299. VCONFIG.EXE     Configuration program described in Chapter 8.
  1300.  
  1301. VJ.EXE          Executable VEDIT Jr. program.
  1302.  
  1303. KEYS.IBM        A graphic representation of the "normal" IBM PC
  1304.                 keyboard layout.
  1305.  
  1306. P.BAT           Batch program to start up the PRINT.VDM macro.
  1307.  
  1308. VJHELP.HLP      Help file accessed by the [HELP] function.
  1309.  
  1310. WORDSTAR.KEY    Keyboard layout file to emulate WordStar (tm).
  1311.                 Described in WORDSTAR.DOC.
  1312.  
  1313. WORDPERF.KEY    Keyboard layout file to emulate WordPerfect (tm).
  1314.                 Described in WORDPERF.DOC.
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.                                    22
  1343.  
  1344.  
  1345. VEDIT Jr.                      Chapter 2                 Getting Started
  1346.  
  1347.  
  1348.                             Keyboard Layout
  1349.                             ---------------
  1350.  
  1351. VEDIT Jr.'s keyboard layout is completely configurable.   The  automated
  1352. installation  lets  you  select  the  initial  keyboard layout.  You can
  1353. modify the initial layout with the {MISC, Keyboard layout} sub-menu. 
  1354.  
  1355. Unless you have a very strong personal preference,  we  recommended  you
  1356. start  off  with  the  "normal"  keyboard layout.  It has been carefully
  1357. thought out to work well with VEDIT Jr.'s features and menu system. 
  1358.  
  1359. All examples in this manual list the name of the edit function  or  menu
  1360. item  and  the  corresponding keystroke in the "normal" keyboard layout.
  1361. Examples are: [HELP] (<F1>) and {BLOCK, Set Marker} <F9>). 
  1362.  
  1363. The initial IBM PCDOS/MS-DOS keyboard layouts are:
  1364.  
  1365. *   NORMAL.  The recommended layout used in this manual.  It requires an
  1366.     AT-style "enhanced" keyboard because keys such  as  <Shft-Up  Arrow>
  1367.     and <Ctrl-Ins> work with VEDIT Jr. only on an enhanced keyboard. 
  1368.  
  1369. *   ALTERNATE.   This  is  very  similar  to  the "normal" layout and is
  1370.     described below.  It should be selected if you have an older IBM  PC
  1371.     without an enhanced keyboard. 
  1372.  
  1373. *   WORDPERF.  Emulates Word Perfect.  Since it has few menu "hot keys",
  1374.     it  helps to access menu functions with a mouse.  Fully described in
  1375.     the file WORDPERF.KEY. 
  1376.  
  1377. *   WORDSTAR.  Emulates WordStar  using  control,  cursor  and  function
  1378.     keys.  Fully described in the file WORDSTAR.KEY. 
  1379.  
  1380. NOTE:  The  following  pages  list the "normal" layout in logical order.
  1381.        Appendix G (not included in the on-disk manual) lists the  layout
  1382.        in  alphabetic  order.   The  layout is available on-line via the
  1383.        [HELP] function and {MISC, Keyboard layout, Display}.  The status
  1384.        line always displays the  current  key  assigned  to  the  [HELP]
  1385.        function. 
  1386.  
  1387.  
  1388. "Alternate" Keyboard Layout
  1389. ---------------------------
  1390.  
  1391. The "Alternate" keyboard layout is identical to the "Normal" layout with
  1392. the  exception  of  these  functions.   It  does  not use any "enhanced"
  1393. keyboard keys. 
  1394.  
  1395. [HELP]           <Alt-F1>            (instead of <F1>)
  1396. [MENU]           <F1>                (instead of <F10>)
  1397. [T-REG COPY]     <Ctrl-F10>          (instead of <Grey+>)
  1398. [T-REG MOVE]     <Alt-F10>           (instead of <Grey->)
  1399. [T-REG INSERT]   <F10>               (instead of <Grey*>)
  1400. [SCROLL UP]      <Ctrl-B>            (instead of <Shft-Up Arrow>)
  1401.  
  1402.  
  1403.                                    23
  1404.  
  1405.  
  1406. VEDIT Jr.                      Chapter 2                 Getting Started
  1407.  
  1408.  
  1409. [SCROLL DOWN]    <Ctrl-V>            (instead of <Shft-Down Arrow>)
  1410. [SCROLL RIGHT]   <Ctrl-Right Arrow>  (instead of <Shft-Right Arrow>)
  1411. [SCROLL LEFT]    <Ctrl-Left Arrow>   (instead of <Shft-Left Arrow>)
  1412.  
  1413.  
  1414. Notes on "Normal" and "Alternate" Layouts
  1415. -----------------------------------------
  1416.  
  1417. *   The "<Grey>" keys are on the very right-hand  side  on  the  IBM  PC
  1418.     keyboard.   The  original  IBM PC keyboard had only <Grey+>, <Grey->
  1419.     and <Grey*>.  The IBM PC "enhanced" keyboards also have <Grey/>  and
  1420.     <Grey.Enter>.  VEDIT treats all of these keys as function keys. 
  1421.  
  1422. *   IBM  PC "enhanced" keys including <F11>, <F12> and the "<Grey>" keys
  1423.     are  normally  supported.   However  if  the  VCONFIG  (Chapter   8)
  1424.     configuration  setting  for  "Keyboard  input"  is  changed from the
  1425.     default "ROM BIOS" to "DOS", these  keys  may  appear  dead.   (Some
  1426.     versions of DOS support them and others do not.)
  1427.  
  1428. *   The "alternate" keyboard layout also assigns [SCROLL UP] to <Ctrl-Up
  1429.     Arrow>  and  [SCROLL  DOWN]  to  <Ctrl-Down  Arrow>.  However, these
  1430.     assignments will only work on an "enhanced" keyboard. 
  1431.  
  1432. *   Since VEDIT treats the <Grey+>, <Grey->, <Grey*> and <Grey/> keys as
  1433.     function  keys,  the  "alternate"  layout  assigns  the  displayable
  1434.     characters "+", "-", "*" and "/" to these keys.  (They are set up as
  1435.     simple keystroke macros.)
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.                                    24
  1465.  
  1466.  
  1467. VEDIT Jr.                      Chapter 2                 Getting Started
  1468.  
  1469.  
  1470. "Normal" IBM PC Keyboard Layout
  1471. -------------------------------
  1472.  
  1473.         [BACKSPACE]             <Backspace>
  1474.         [BLOCK COPY]            <Ctrl-F9>
  1475.         [BLOCK MOVE]            <Alt-F9>
  1476.         [CANCEL]                <Ctrl-C>
  1477.         [CURSOR UP]             <Up Arrow>
  1478.         [CURSOR DOWN]           <Down Arrow>
  1479.         [CURSOR RIGHT]          <Right Arrow>
  1480.         [CURSOR LEFT]           <Left Arrow>
  1481.         [DELETE]                <Del>
  1482.         [DEL PREV WORD]         <Alt-F5>
  1483.         [DEL NEXT WORD]         <Alt-F6>
  1484.         [ENTER CTRL]            <Alt-Q>    or    <Ctrl-Q>
  1485.         [ERASE EOL]             <Ctrl-Z>
  1486.         [ERASE LINE]            <Ctrl-Y>    or    <Ctrl-X>
  1487.         [ESCAPE]                <Esc>
  1488.         [HELP]                  <F1>
  1489.         [INDENT]                <F8>
  1490.         [INSERT TOGGLE]         <Ins>
  1491.         [LINE BEGIN]            <Home>
  1492.         [LINE END]              <End>
  1493.         [MENU]                  <F10>
  1494.         [NEXT LINE]             <Ctrl-Enter> (Same as <Ctrl-J>)
  1495.         [NEXT PARAGRAPH]        <Ctrl-F6>
  1496.         [NEXT TAB STOP]         <SHIFT Tab>
  1497.         [NEXT WORD]             <F6>    or    <Ctrl-Right Arrow>
  1498.         [PAGE UP]               <PgUp>
  1499.         [PAGE DOWN]             <PgDn>
  1500.         [PREV PARAGRAPH]        <Ctrl-F5>
  1501.         [PREV WORD]             <F5>    or    <Ctrl-Left Arrow>
  1502.         [REPEAT]                <Ctrl-R>
  1503.         [REPEAT LAST]           <Alt-R>
  1504.         [REPLACE]               <Alt-F2>
  1505.         [SCREEN BEGIN]          <Ctrl-Home>
  1506.         [SCREEN END]            <Ctrl-End>
  1507.         [SCROLL UP]             <Shft-Up Arrow>
  1508.         [SCROLL DOWN]           <Shft-Down Arrow>
  1509.         [SCROLL RIGHT]          <Shft-Right Arrow>
  1510.         [SCROLL LEFT]           <Shft-Left Arrow>
  1511.         [SEARCH]                <F2>
  1512.         [SEARCH AGAIN]          <F3>
  1513.         [TAB CHARACTER]         <Tab>
  1514.         [T-REG COPY]            <Ctrl-Ins>    or    <Grey+>
  1515.         [T-REG MOVE]            <Shft-Del>    or    <Grey->
  1516.         [T-REG INSERT]          <Shft-Ins>    or    <Grey*>
  1517.         [UNDENT]                <F7>
  1518.         [VISUAL EXIT]           <Ctrl-E>    or    <Grey/>
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.                                    25
  1526.  
  1527.  
  1528. VEDIT Jr.                      Chapter 2                 Getting Started
  1529.  
  1530.  
  1531. "Normal" IBM PC Keyboard Layout cont.
  1532. -------------------------------------
  1533.  
  1534.     Built-in Keystroke Macros:
  1535.  
  1536.         <Alt-B>                 Access {BLOCK} menu
  1537.         <Alt-C>                 Access {CONFIG} menu
  1538.         <Alt-E>                 Access {EDIT} menu
  1539.         <Alt-F>                 Access {FILE} menu
  1540.         <Alt-G>                 Access {GOTO} menu
  1541.         <Alt-H>                 Access {HELP} menu
  1542.         <Alt-M>                 Access {MISC} menu
  1543.         <Alt-P>                 Access {PRINT} menu
  1544.         <Alt-S>                 Access {SEARCH} menu
  1545.  
  1546.         <F9>                    Set a "character" type block marker
  1547.         <Ctrl-N>                Set a "column" type block marker
  1548.         <Ctrl-F>                Format the current paragraph
  1549.         <Ctrl-Pg Up>            Go to the beginning of the file
  1550.         <Ctrl-Pg Dn>            Go to the end of the file
  1551.         <Ctrl-S>                Set a text marker
  1552.         <Ctrl-G>                Goto a text marker
  1553.         <Alt-F3>                Goto matching parenthesis - () <> [] {}
  1554.         <Alt-J>                 Toggle between text colors
  1555.         <Alt-L>                 Toggle between 25 and 43/50 line
  1556.                                 screen (EGA/VGA)
  1557.         <Ctrl-K>                Add a new keystroke macro
  1558.         <Alt-K>                 Start/stop recording a new keystroke macro
  1559.         <Ctrl-P>                Print a block of text
  1560.         <Ctrl-U>                Undo current/previous line
  1561.         <Alt-Bksp>              Undo last edit operation (keystroke)
  1562.         <Ctrl-Bksp>             Erase from cursor to beginning of line
  1563.         <Alt-N>                 Edit next file (save/abandon current file)
  1564.         <Alt-X>                 Exit VEDIT Jr. - save/abandon file
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                                    26
  1587.  
  1588.  
  1589. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1590.  
  1591.  
  1592. Chapter 3 - Quick Tutorial
  1593. ------------------------------------------------------------------------
  1594.  
  1595.  
  1596. Let's  take  a  quick  tour of VEDIT Jr.  In this chapter you will learn
  1597. basic text editing, using the menu system,  displaying  help  and,  most
  1598. importantly,  how  to  save  the  results.   In short, you will know all
  1599. that's required to really use VEDIT Jr.! 
  1600.  
  1601. Each basic editing function in VEDIT Jr. has a name  which  we  normally
  1602. show  as  in  [HELP]  and [CURSOR RIGHT].  We show which key to press to
  1603. perform the editing functions as in <F1> and <Cursor Right>. 
  1604.  
  1605. To keep things simple, this quick tutorial often just lists which key to
  1606. press to perform various editing operations.  However, the rest of  this
  1607. manual is oriented towards the names of the editing functions. 
  1608.  
  1609. NOTE:   Since this quick tutorial is specific on which keys to press, it
  1610.         assumes  that  you  have  installed  VEDIT Jr. on  an IBM PC and
  1611.         selected the "Normal" keyboard layout. 
  1612.  
  1613.  
  1614. Starting VEDIT Jr. 
  1615. ------------------
  1616.  
  1617. To start VEDIT Jr. and begin editing a file called NEWS.TXT, type:
  1618.  
  1619.     VEDIT NEWS.TXT
  1620.  
  1621. Unless you already have a file called NEWS.TXT in the current directory,
  1622. VEDIT Jr. will create this file for you.  If the file does exist,  VEDIT
  1623. Jr.   will  load  it  and display the beginning of the file.  The screen
  1624. will appear as:
  1625.  
  1626.   NEWS.TXT        LINE:    1   COL:   1                 INS             F1=HELP
  1627. ╒═════════════════════════════════════════════════════════════════════════════╕
  1628. │▓                                                                            │
  1629. │                                                                             │
  1630. │                                                                             │
  1631. │                                                                             │
  1632. │                                                                             │
  1633. │                                                                             │
  1634. ╘═════════════════════════════════════════════════════════════════════════════╛
  1635.  
  1636.  
  1637. The "status line" at the top of the screen indicates  the  name  of  the
  1638. file  being edited, the location of the cursor by line number and column
  1639. number, and which key performs the [HELP] function. 
  1640.  
  1641. The status line is also used to display prompts, error messages and  the
  1642. top line of the menu system. 
  1643.  
  1644. The  "cursor"  is  initially  at the top left of the screen.  The cursor
  1645.  
  1646.  
  1647.                                    27
  1648.  
  1649.  
  1650. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1651.  
  1652.  
  1653. indicates the exact location at which any edit changes, such  as  typing
  1654. in new text, will be made. 
  1655.  
  1656.  
  1657. Entering New Text
  1658. -----------------
  1659.  
  1660. VEDIT Jr. starts  up  in  "Insert  Mode".   As you type, new letters are
  1661. inserted at the cursor position.  You can tell that  VEDIT  Jr.   is  in
  1662. Insert Mode by the "INS" on the status line.  If you do not see "INS" on
  1663. the  status  line,  press  <Ins>  once  (the  [INSERT TOGGLE] function).
  1664. VEDIT Jr. is usually configured to  have  a  different  cursor  type  in
  1665. "Insert" and "Overstrike" modes. 
  1666.  
  1667. You can now type some text which will appear on the screen and will soon
  1668. be made into a file.  Type in the following text.  Press the <Enter> key
  1669. at  the  end of each line.  You can make simple corrections while typing
  1670. by pressing <Backspace>. 
  1671.  
  1672.   NEWS.TXT        LINE:    6   COL:   1                 INS             F1=HELP
  1673. ╒═════════════════════════════════════════════════════════════════════════════╕
  1674. │Bach simply awed the professional musicians                                  │
  1675. │who met or just observed him. Their descriptions                             │
  1676. │indicate that Bach, at the head of an orchestra,                             │
  1677. │was a conductor very much like the great                                     │
  1678. │conductors of today.                                                         │
  1679. │▓                                                                            │
  1680. ╘═════════════════════════════════════════════════════════════════════════════╛
  1681.  
  1682.  
  1683. Pressing the <Enter> key moves the cursor to the beginning of  the  next
  1684. line.   When you press <Enter> while in Insert Mode, you are inserting a
  1685. "newline" character.  Every text line ends in a "newline" character. 
  1686.  
  1687. (The "newline" character is normally invisible, but like many things  in
  1688. VEDIT Jr., you can configure it to be visible. 
  1689.  
  1690.  
  1691. Moving the Cursor
  1692. -----------------
  1693.  
  1694. You  can  move  the cursor to another part of the text using the "Cursor
  1695. Control" (arrow) keys:
  1696.  
  1697.                   <Cursor Up>
  1698.  
  1699.         <Cursor Right> <Cursor Left>
  1700.  
  1701.                   <Cursor Down>
  1702.  
  1703. To move the cursor back to the first line, press <Cursor Up>  until  the
  1704. cursor  is back on the first line.  If you keep pressing <Cursor Up> the
  1705. cursor will no longer move, because you're at the beginning of the file.
  1706.  
  1707.  
  1708.                                    28
  1709.  
  1710.  
  1711. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1712.  
  1713.  
  1714. Similarly, if you press <Cursor Down> while on the last line, the cursor
  1715. will not move any further because you are at the end of the file. 
  1716.  
  1717. Pressing <Cursor Left> while at the beginning of a line  will  move  the
  1718. cursor  to  the  end  of the previous line.  Similarly, pressing <Cursor
  1719. Right> while at the end of a line will move the cursor to the  beginning
  1720. of the following line. 
  1721.  
  1722. With  the  default  configuration,  VEDIT Jr. only lets you position the
  1723. cursor at real characters in the text and at the  ends  of  lines.   You
  1724. cannot  position  the  cursor  on  the  screen  where  there is no text.
  1725. However, VEDIT Jr. has several "Cursor Positioning Modes" which let  you
  1726. modify this behavior. 
  1727.  
  1728.  
  1729. Deleting Text
  1730. -------------
  1731.  
  1732. You  can delete the character at the cursor by pressing <Del>.  When you
  1733. do that, the character just after the cursor will be "drawn back" to the
  1734. cursor position. 
  1735.  
  1736. Move the cursor just before the word "the":
  1737.  
  1738.     Bach simply awed▓the professional musicians
  1739.  
  1740. To delete the word (and the extra space) press <Del> four times:
  1741.  
  1742.     Bach simply awed▓professional musicians
  1743.  
  1744. You can also delete the character just before the cursor by pressing the
  1745. <Backspace> key.  This is helpful when you want to change the  word  you
  1746. just typed. 
  1747.  
  1748. If you now press <Backspace> five times, the line will be:
  1749.  
  1750.     Bach simply▓professional musicians
  1751.  
  1752. Earlier  in  this  chapter,  when  you  wanted  to start a new line, you
  1753. inserted what we called a "newline"  character  with  the  <Enter>  key.
  1754. While  you  cannot  actually  see  it,  a  "newline"  really  is  like a
  1755. character.  (Technically, for DOS files it is two characters a "carriage
  1756. return" and a "line feed".) When you type a  character  key,  a  visible
  1757. character is inserted.  Similarly, pressing <Enter> inserts a "newline".
  1758. Also,  just as <Del> or <Backspace> delete visible characters, they will
  1759. also delete a "newline" or a space. 
  1760.  
  1761. To show this, move the cursor to the "T" in the word "Their"  and  press
  1762. <Enter> to split the line in two:
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.                                    29
  1770.  
  1771.  
  1772. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1773.  
  1774.  
  1775.   NEWS.TXT        LINE:    3   COL:   1                 INS             F1=HELP
  1776. ╒═════════════════════════════════════════════════════════════════════════════╕
  1777. │Bach simply awed the professional musicians                                  │
  1778. │who met or just observed him.                                                │
  1779. │▓heir descriptions                                                           │
  1780. │indicate that Bach, at the head of an orchestra,                             │
  1781. │was a conductor very much like the great                                     │
  1782. │conductors of today.                                                         │
  1783. ╘═════════════════════════════════════════════════════════════════════════════╛
  1784.  
  1785.  
  1786. As you can see, a "newline" has been inserted. 
  1787.  
  1788. Now press <Backspace> to delete the "newline" again:
  1789.  
  1790.   NEWS.TXT        LINE:    2   COL:  31                 INS             F1=HELP
  1791. ╒═════════════════════════════════════════════════════════════════════════════╕
  1792. │Bach simply awed the professional musicians                                  │
  1793. │who met or just observed him. ▓heir descriptions                             │
  1794. │indicate that Bach, at the head of an orchestra,                             │
  1795. │was a conductor very much like the great                                     │
  1796. │conductors of today.                                                         │
  1797. │                                                                             │
  1798. ╘═════════════════════════════════════════════════════════════════════════════╛
  1799.  
  1800.  
  1801. Of  course  the <Del> key can also delete characters, and a "newline" is
  1802. no exception. 
  1803.  
  1804. Try the following:
  1805.  
  1806.     <Enter> <Cursor Left> <Del>
  1807.  
  1808. In short, when you're at the beginning of a line and want to  append  it
  1809. to  the  previous  line, press <Backspace>.  When you're at the end of a
  1810. line and want to append the following line, press <Del>. 
  1811.  
  1812. You can delete an entire line by  pressing  <Ctrl-Y>  (the  [ERASE LINE]
  1813. function); any following lines will then move up. 
  1814.  
  1815. You  can  delete text from the cursor position to the end of the line by
  1816. pressing <Ctrl-Z> (the [ERASE EOL] function).  You  can  blank  out  the
  1817. current  line  by  first  pressing  <Home>  and  then <Ctrl-Z>.  This is
  1818. different from <Ctrl-Y> in that it changes a line of  text  to  a  blank
  1819. line instead of erasing it entirely. 
  1820.  
  1821.  
  1822. Typing Beyond the Visible Screen Area
  1823. -------------------------------------
  1824.  
  1825. Now  lets  see  what  happens when you type in more than a single screen
  1826. full of text.  Move the cursor to the end of your current text and press
  1827. <Enter>.  Then repeatedly type a few characters and press <Enter>  until
  1828.  
  1829.  
  1830.                                    30
  1831.  
  1832.  
  1833. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1834.  
  1835.  
  1836. you reach the bottom of the screen. 
  1837.  
  1838. As  you  get near the bottom of the screen, VEDIT Jr. will automatically
  1839. "scroll" the text upward to make room for  new  text.   In  effect,  you
  1840. could keep typing forever. 
  1841.  
  1842. Now  try  typing  a very long line.  As you get to the right side of the
  1843. screen, just keep typing.  VEDIT Jr. will automatically scroll the  text
  1844. to the left to make room for the new text. 
  1845.  
  1846.  
  1847. Line and Column Numbers
  1848. -----------------------
  1849.  
  1850. VEDIT Jr. tells you exactly where you are in your file by displaying the
  1851. line  and  column  number  of  the current cursor position on the status
  1852. line.  Note the "LINE" and "COL" displayed on the status line. 
  1853.  
  1854. In the previous example, VEDIT Jr. had scrolled the text  to  the  left.
  1855. If  you  look  at  the status line in that example, you will notice that
  1856. "COL:" had changed to "20:", which tells you that the left edge  of  the
  1857. screen  is  at  column 20.  The real column number is still displayed on
  1858. the status line in its normal location. 
  1859.  
  1860.  
  1861. Quick Cursor Movement
  1862. ---------------------
  1863.  
  1864. Using arrow keys to move the cursor might be fine if you do not have far
  1865. to go, but what about long distance jumps?  Fortunately the  arrow  keys
  1866. are  only  some  of  the  cursor control keys available.  In addition to
  1867. moving line by line or character by character, there are keys which  can
  1868. move  the  cursor  by words, paragraphs, screens and to the beginning or
  1869. end of a line or screen.  Other movements using the {GOTO} menu are also
  1870. possible and are described later in  this  manual.   (But  not  in  this
  1871. on-disk documentation.)
  1872.  
  1873.  
  1874. Moving by Words
  1875. ---------------
  1876.  
  1877. To move the cursor forward an entire word, press:
  1878.  
  1879.     <F6>     [NEXT WORD]
  1880.  
  1881. To move the cursor backward an entire word, press:
  1882.  
  1883.     <F5>     [PREV WORD]
  1884.  
  1885. The  <F5>  and  <F6>  keys  will  always  place  the cursor on the first
  1886. character of a word.  If the cursor is not currently at a word, pressing
  1887. <F6> will move the cursor to the first character of the  next  word  and
  1888. <F5> to the first character of the previous word. 
  1889.  
  1890.  
  1891.                                    31
  1892.  
  1893.  
  1894. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1895.  
  1896.  
  1897. Moving to the Beginning or End of a Line
  1898. ----------------------------------------
  1899.  
  1900. To move the cursor to the end of the current line, press:
  1901.  
  1902.     <End>     [LINE END]
  1903.  
  1904. If  the  cursor  is already at the end of the current line when <End> is
  1905. pressed, the cursor will move the the end of the next line. 
  1906.  
  1907. To move the cursor to the beginning of the current line, press:
  1908.  
  1909.     <Home>     [LINE BEGIN]
  1910.  
  1911. If the cursor is already at the  beginning  of  the  current  line  when
  1912. <Home> is pressed, the cursor will move to the beginning of the previous
  1913. line. 
  1914.  
  1915. From  working with other editors and word processors, you may be used to
  1916. the <Home> and <End> working differently than they do in  VEDIT Jr.   Do
  1917. not  worry, VEDIT Jr. has many configuration options that let it closely
  1918. emulate other editing styles you may already be used to. 
  1919.  
  1920.  
  1921. Moving by Screens
  1922. -----------------
  1923.  
  1924. Well, actually just less than a screen.  VEDIT Jr. comes  configured  to
  1925. "page"  the screen up or down two lines less than the actual text screen
  1926. size.  This allows some overlap between screens of text, thus  providing
  1927. a visual reference for easier reading. 
  1928.  
  1929. To move the cursor forward an entire screen page, press:
  1930.  
  1931.     <PgDn>     [PAGE DOWN]
  1932.  
  1933. To move the cursor backward an entire screen page, press:
  1934.  
  1935.     <PgUp>     [PAGE UP]
  1936.  
  1937. Even  though  these functions refer to "pages", they bear no relation to
  1938. printed pages for a completed document.  They are simply "screen"  pages
  1939. and  their  size  depends  mostly  on  the  number of lines of text your
  1940. computer displays. 
  1941.  
  1942.  
  1943. Moving by Paragraphs
  1944. --------------------
  1945.  
  1946. What is a paragraph?  Since VEDIT Jr. is a "Plain Text" editor, it  does
  1947. not introduce unseen control characters to mark where one paragraph ends
  1948. and  the  next  begins.   Instead,  it considers a blank line as a break
  1949. between paragraphs.   Even  when  the  first  line  of  a  paragraph  is
  1950.  
  1951.  
  1952.                                    32
  1953.  
  1954.  
  1955. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  1956.  
  1957.  
  1958. indented,  if  there  is  not  a  blank line between it and the previous
  1959. paragraph, VEDIT Jr. will think it's all one big paragraph. 
  1960.  
  1961. To move the cursor forward an entire paragraph press:
  1962.  
  1963.     <Ctrl-F6>     [NEXT PARAGRAPH]
  1964.  
  1965. To move the cursor backward an entire paragraph press:
  1966.  
  1967.     <Ctrl-F5>     [PREV PARAGRAPH]
  1968.  
  1969. The <Ctrl-F6> and <Ctrl-F5> keys always place the cursor  on  the  first
  1970. character  of  a  paragraph.   If  the  cursor  is  not  currently  at a
  1971. paragraph,  pressing  <Ctrl-F6>  will  move  the  cursor  to  the  first
  1972. character  of the next paragraph and <Ctrl-F5> to the first character of
  1973. the previous paragraph. 
  1974.  
  1975.  
  1976. Undo
  1977. ----
  1978.  
  1979. VEDIT Jr. offers you the luxury of  changing  your  mind.   Perhaps  you
  1980. changed some text, then decided it was better before the change.  Rather
  1981. than  deleting  and  retyping,  you  can  ask  VEDIT Jr. to "undo" those
  1982. changes. 
  1983.  
  1984. To undo your last action press:
  1985.  
  1986.     <Alt-Bksp>
  1987.  
  1988. Each press of <Alt-Bksp> undoes the next previous action.  Actions which
  1989. can be "undone" in this way include inserting or overwriting characters,
  1990. deleting characters and cursor movements.  Up to the last 1,000 of these
  1991. actions can be undone by repeatedly pressing <Alt-Bksp>. 
  1992.  
  1993. To try it, first delete a line of text by pressing <Ctrl-Y>.  Then press
  1994. <Alt-Bksp> and the line comes  back.   Go  ahead  and  make  some  other
  1995. changes  deleting,  overwriting and inserting text.  Repeatedly pressing
  1996. <Alt-Bksp> will reverse these changes step by step. 
  1997.  
  1998. You can also undo changes line by line by pressing <Ctrl-U>.  This is  a
  1999. quick  way  to undo all the changes you just made to a line, but did not
  2000. intend to make. 
  2001.  
  2002. For this tutorial you do not want to repeatedly press  <Ctrl-U>  or  you
  2003. will  soon  end  up  with a blank screen because that is how you started
  2004. out.  You cannot reverse the effect of an Undo function. 
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.                                    33
  2014.  
  2015.  
  2016. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2017.  
  2018.  
  2019. Using Menus
  2020. -----------
  2021.  
  2022. So far, you have learned how to perform  basic  operations  by  pressing
  2023. particular  keys  which  are assigned to them.  Most of these operations
  2024. are also available using menus, along with  many  that  do  not  have  a
  2025. direct keypress equivalent. 
  2026.  
  2027. To activate the menu system, press:
  2028.  
  2029.     <F10>     [MENU]
  2030.  
  2031. VEDIT Jr. will replace the status line with a horizontal menu bar.  This
  2032. is  the "main menu" which shows the names of each "pull-down" menu.  One
  2033. item in the main menu will be highlighted and a pull-down menu  will  be
  2034. displayed.   VEDIT Jr. shows  you  this  pull-down  menu  in  advance of
  2035. actually selecting it as a reference of what is available in it. 
  2036.  
  2037.  
  2038.      File  Edit  Block  Goto  Misc  Print  Search  Config  Help
  2039.      ╒═══════════════════════╕
  2040.      │ Browse mode        No │
  2041.      │ New                   │
  2042.      │ Open...        Ctrl-N │
  2043.      │ Directory (change)... │
  2044.      │ Save as...            │
  2045.      │ Save and continue     │
  2046.      │ Exit            Alt-X │
  2047.      ╘═══════════════════════╛
  2048.  
  2049.  
  2050. NOTES: If the main  menu  does  not  have  a  highlighted  item  or  the
  2051.        pull-down   menus   appear  blank,  you  may  need  to  start  up
  2052.        VEDIT Jr. with the "-b" monochrome option.   Assuming  the  menus
  2053.        are   now   readable,   you  can  save  the  monochrome  settings
  2054.        permanently into the VJ.EXE file by selecting {CONFIG, Save  into
  2055.        VEDIT}. 
  2056.  
  2057.        VEDIT Jr. displays sub-menus before they are selected so that you
  2058.        can  preview  the  items  in  the  sub-menu.   This  has a little
  2059.        different "look" from some other menu systems, but the keystrokes
  2060.        are the same.   Although  we  think  that  our  sub-menu  preview
  2061.        feature  is  very  useful, you can disable it.  This is described
  2062.        under "Using Menus" in Chapter 4 (Editing Guide).  It  should  be
  2063.        noted that other menus systems and VEDIT always preview sub-menus
  2064.        when using a mouse. 
  2065.  
  2066. To highlight a different main menu item, press:
  2067.  
  2068.     <Cursor Right> or <Cursor Left>
  2069.  
  2070. Try  highlighting  each  item  in the main menu and examine the items in
  2071. each pull-down menu. 
  2072.  
  2073.  
  2074.                                    34
  2075.  
  2076.  
  2077. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2078.  
  2079.  
  2080.  
  2081. Before you can make a selection from a pull-down menu you must select it
  2082. from the main menu. 
  2083.  
  2084. Highlight "File" and press <Enter> to select the {FILE} menu:
  2085.  
  2086.  
  2087.      File  Edit  Block  Goto  Misc  Print  Search  Config  Help
  2088.      ╒═══════════════════════╕
  2089.      │ Browse mode        No │
  2090.      │ New                   │
  2091.      │ Open...        Ctrl-N │
  2092.      │ Directory (change)... │
  2093.      │ Save as...            │
  2094.      │ Save and continue     │
  2095.      │ Exit            Alt-X │
  2096.      ╘═══════════════════════╛
  2097.  
  2098.  
  2099. You can tell that you have selected a pull-down menu  by  the  highlight
  2100. bar  which  appears  in it.  You can move this bar up and down to select
  2101. the desired item. 
  2102.  
  2103. To highlight a different menu item, press:
  2104.  
  2105.     <Cursor Down> or <Cursor Up> or <Space Bar>
  2106.  
  2107. Try highlighting each item in the {FILE} menu. 
  2108.  
  2109. Items in the pull-down menus can also be selected  by  highlighting  the
  2110. desired  one  and  pressing  <Enter>.   In  some  cases these items will
  2111. themselves be sub-menus.  For example, in  the  {MISC}  menu,  the  item
  2112. {MISC, Keyboard Layout} is a sub-menu. 
  2113.  
  2114.  
  2115. Answering a Prompt
  2116. ------------------
  2117.  
  2118. The  "Directory"  item in the {FILE} menu lets you view the names of all
  2119. files in your current directory or any other directory you specify.  You
  2120. can then press <Enter> to have VEDIT Jr. display the  current  directory
  2121. or you can type in the directory of your choice. 
  2122.  
  2123. To  display  the  current  directory, select "Directory" from the {FILE}
  2124. menu; at the "Enter filename:" prompt simply press <Enter>. 
  2125.  
  2126. A typical display might be:
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.                                    35
  2136.  
  2137.  
  2138. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2139.  
  2140.  
  2141.     ╒══════════════════════════════════════════════════════════════════╕
  2142.     │ C:\VEDIT\*.*                                                     │
  2143.     │ ..            VEDIT.EXE     VCONFIG.EXE   VHELP.HLP    ERRATA.DOC│
  2144.     │ WORDSTAR.KEY  WORDPERF.KEY  KEYS.IBM      README.BAT   WHATS.NEW │
  2145.     │ COMPARE.VDM   DISPLAY.VDM   KEY-MAC.LIB   MACROS.LIB   PRINT.VDM │
  2146.     │ SORT.VDM      NEWS.TXT                                           │
  2147.     ╘══════════════════════════════════════════════════════════════════╛
  2148.  
  2149.  
  2150. This is VEDIT Jr.'s "point  &  shoot"  file  selection  window.   It  is
  2151. displayed  any  time  you respond to the "Enter Filename" prompt by just
  2152. pressing <Enter>.  It is usually used when selecting new files to  edit.
  2153. "Point  and  Shoot  File Section" in Chapter 4 (Editing Guide) describes
  2154. this in more detail. 
  2155.  
  2156. When you're done viewing the directory, press <Esc>.  VEDIT Jr.  will go
  2157. back to displaying your text. 
  2158.  
  2159. To display  the  contents  of  the  directory  "C:\DOS",  select  {FILE,
  2160. Directory} as before.  At the "Enter filename:" prompt enter:
  2161.  
  2162.     C:\DOS\*.* <Enter>
  2163.  
  2164. In the typical screen below, notice that the top line indicates that the
  2165. files in the "C:\DOS" directory are now being displayed. 
  2166.  
  2167.     ╒════════════════════════════════════════════════════════════════════╕
  2168.     │ C:\DOS\*.*                                                         │
  2169.     │ ..            ASSIGN.COM   BACKUP.COM    BASIC.COM    BASICA.COM   │
  2170.     │ CHKDSK.COM    COMMAND.COM  COMP.COM      DEBUG.COM    DISKCOMP.COM │
  2171.     │ DISKCOPY.COM  EDLIN.COM    FDISK.COM     FORMAT.COM   GRAFTABL.COM │
  2172.     │ GRAPHICS.COM  KEYBGR.COM   KEYENH.COM    LABEL.COM    MODE.COM     │
  2173.     │ MORE.COM      PRINT.COM    RESTORE.COM   SELECT.COM   SHIPTRAK.COM │
  2174.     │ SYS.COM       TREE.COM     APPEND.EXE    ATTRIB.EXE   BASIC.EXE    │
  2175.     │ CHKDSK.EXE    EXE2BIN.EXE  FIND.EXE      JOIN.EXE     LINK.EXE     │
  2176.     │ REPLACE.EXE   SHARE.EXE    SORT.EXE      SUBST.EXE    XCOPY.EXE    │
  2177.     │ ANSI.SYS      DRIVER.SYS   HDRIVE.SYS    VDISK.SYS                 │
  2178.     ╘════════════════════════════════════════════════════════════════════╛
  2179.  
  2180.  
  2181. Response History
  2182. ----------------
  2183.  
  2184. VEDIT Jr. remembers  what you enter in response to its prompts.  You can
  2185. recall and reuse these past responses or even edit them. 
  2186.  
  2187. For example, to see this in action select {FILE, Directory}  again.   At
  2188. the "Enter Filename" press:
  2189.  
  2190.     <Cursor Up>
  2191.  
  2192. This will recall the previous "C:\DOS\*.*" entry. 
  2193.  
  2194.  
  2195.  
  2196.                                    36
  2197.  
  2198.  
  2199. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2200.  
  2201.  
  2202.      File  Edit  Block  Goto  Misc  Print  Search  Config  Help
  2203.      ╒═══════════════════════╕
  2204.      │ Browse mode        No │
  2205.      │ New                   │
  2206.      │ Open...        Ctrl-N │
  2207.      │ Directory (change)... │
  2208.    ╒═══════════════════════════════════════════════════════════════════════╕
  2209.    │ Enter Filename: C:\DOS\*.*                                            │
  2210.    ╘═══════════════════════════════════════════════════════════════════════╛
  2211.      ╘═══════════════════════╛
  2212.  
  2213.  
  2214. HINT:  While  editing  a  response,  the  <Cursor Right>, <Cursor Left>,
  2215.        <Home>, <End>, <Backspace> and <Del> keys may also be used. 
  2216.  
  2217.  
  2218. Exiting the Menu System
  2219. -----------------------
  2220.  
  2221. To back up, or you might say "escape" from the current menu, press:
  2222.  
  2223.     <Esc>
  2224.  
  2225. Pressing <Esc> will take you back one menu level.  Pressing  <Esc>  from
  2226. the main menu removes the menu system. 
  2227.  
  2228. Pressing <Esc> while editing pops up the special "Escape" menu (which is
  2229. described  later).  Of course, you can press <Esc> to leave the "Escape"
  2230. menu too. 
  2231.  
  2232. You can also jump totally out of the menus from any point.  To quit  the
  2233. menu system, press:
  2234.  
  2235.     <Ctrl-C>
  2236.  
  2237. <Ctrl-C>  (the  [CANCEL]  function)  cancels  any operation in progress.
  2238. Pressing it from anywhere within the menu system immediately removes the
  2239. menu system. 
  2240.  
  2241. You can think of  <Ctrl-C>  as  the  "Panic  Button".   It  cancels  any
  2242. function which is prompting you and aborts any printing in progress. 
  2243.  
  2244. Even  if  your  keyboard layout has some other key assigned to [CANCEL],
  2245. <Ctrl-C> will abort any printing,  abort  any  command  macro  which  is
  2246. running and, in most cases, cancel any prompt. 
  2247.  
  2248.  
  2249. Context Sensitive Help
  2250. ----------------------
  2251.  
  2252. VEDIT Jr. provides  context sensitive on-line help.  When you press <F1>
  2253. (the [HELP] function), VEDIT Jr. will  "pop-up"  additional  information
  2254. related to what you are currently doing. 
  2255.  
  2256.  
  2257.                                    37
  2258.  
  2259.  
  2260. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2261.  
  2262.  
  2263.  
  2264. *   If the menu system is active, the information is on the current menu
  2265.     selection. 
  2266.  
  2267. *   If  VEDIT Jr. is  prompting  you  for  something, the information is
  2268.     related to how you should respond. 
  2269.  
  2270. *   Otherwise, (i.e. if you are  on  a  text  screen  without  menus  or
  2271.     prompts),  the  information  describes the special keys available to
  2272.     you. 
  2273.  
  2274. For example, activate the menu system and  directly  access  the  {FILE}
  2275. menu  by  pressing <Alt-F>.  Then press <F1> and you should see a screen
  2276. like this:
  2277.  
  2278.      File  Edit  Block  Goto  Misc  Print  Search  Config  Help
  2279.      ╒═══════════════════════╕
  2280.      │ Browse mode        No │
  2281.   ╒════════════════════════════════════════════════════════════════════════╕
  2282.   │{FILE} Menu --                                                          │
  2283.   │Browse mode  Enables/disables browse mode for the current file and the  │
  2284.   │             next file edited.                                          │
  2285.   │                                                                        │
  2286.   │             When set to "Yes", the next file edited using {FILE, Open} │
  2287.   │             (<Alt-N>) will be opened in a fast "browse-only" mode.     │
  2288.   │                                                                        │
  2289.   │New          Empties (closes) the buffer. If the buffer contains an     │
  2290.   │             altered file, you are prompted whether the file should be  │
  2291.   │             saved or abandoned.                                        │
  2292.   │Press any key to continue                                               │
  2293.   ╘════════════════════════════════════════════════════════════════════════╛
  2294.  
  2295.  
  2296. The displayed help information may be more than one page long.  You  can
  2297. advance  to  the  next  page  by pressing any key.  After the last page,
  2298. VEDIT Jr. will return to the way it was before you asked for help. 
  2299.  
  2300.  
  2301. Keyboard Help
  2302. -------------
  2303.  
  2304. VEDIT Jr. can also display a list of keystrokes and the operations  they
  2305. perform.   To  display keystroke help, make sure you are not in the menu
  2306. system and press <F1>.  The resulting screen should look like this:
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.                                    38
  2319.  
  2320.  
  2321. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2322.  
  2323.  
  2324. ╒══════════════════════════════ Keyboard Help ════════════════════════════════╕
  2325. │[BACKSPACE]       Backspace          [NEXT LINE]        Ctrl-Enter           │
  2326. │[BLOCK COPY]      F9                 [NEXT PARAGRAPH]   Ctrl-F6              │
  2327. │[BLOCK MOVE]      Alt-F9             [NEXT WORD]        F6                   │
  2328. │[CANCEL]          Ctrl-C             [PAGE UP]          PgUp                 │
  2329. │    .                .                   .                 .                 │
  2330. │    .                .                   .                 .                 │
  2331. │    .                .                   .                 .                 │
  2332. │    .                .                   .                 .                 │
  2333. │[HELP]            F1                 [SCROLL LEFT]      Ctrl-Cursor-Left     │
  2334. │[INDENT]          F8                 [TAB CHARACTER]    Tab                  │
  2335. │[INSERT TOGGLE]   Ins                [T-REG COPY]       Ctrl-Ins             │
  2336. │[LINE BEGIN]      Home               [T-REG MOVE]       Shft-Del             │
  2337. │[LINE END]        End                [T-REG INSERT]     Shft-Ins             │
  2338. │[MENU]            F10                [UNDENT]           F7                   │
  2339. │Press key for desired function or <Enter> for next screen:                   │
  2340. ╘═════════════════════════════════════════════════════════════════════════════╛
  2341.  
  2342.  
  2343. Each basic "edit function" is shown along with the keys assigned to  it.
  2344. These are described in detail in Chapter 7 (Edit Function Reference). 
  2345.  
  2346. From this display, you can obtain additional information on a particular
  2347. edit function by pressing the key(s) assigned to that function. 
  2348.  
  2349. For example, to display additional help on [LINE END], press <End>.  You
  2350. should see the following screen:
  2351.  
  2352. ╒══════════════════════════════ Keyboard Help ════════════════════════════════╕
  2353. │[LINE BEGIN]          Moves the cursor to the first character of the current │
  2354. │                      line or, if already there, to the first character of   │
  2355. │                      the previous text line.                                │
  2356. │                                                                             │
  2357. │[LINE END]            Moves the cursor to the end of the current line or,    │
  2358. │                      if already there, to the end of the next line of text. │
  2359. │                                                                             │
  2360. │                      The behavior of [LINE BEGIN] and [LINE END] can be     │
  2361. │                      changed with {CONFIG, Emulation, Line emulation}.      │
  2362. │                                                                             │
  2363. │[NEXT LINE]           Moves the cursor to the beginning of the next line of  │
  2364. │                      text.                                                  │
  2365. │                                                                             │
  2366. │Press any key to continue                                                    │
  2367. ╘═════════════════════════════════════════════════════════════════════════════╛
  2368.  
  2369.  
  2370. General Help
  2371. ------------
  2372.  
  2373. VEDIT Jr. can also provide help information on particular topics.  First
  2374. press [HELP] and then the <Enter> key twice:
  2375.  
  2376.  
  2377.  
  2378.  
  2379.                                    39
  2380.  
  2381.  
  2382. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2383.  
  2384.  
  2385. ╒══════════════════════════════ Keyboard Help ════════════════════════════════╕
  2386. │                   HELP TOPICS                                               │
  2387. │                                                                             │
  2388. │STAT          Status line messages                                           │
  2389. │MARG          Setting left and right margins                                 │
  2390. │FORM          Formatting paragraphs                                          │
  2391. │HZ            Horizontal scrolling                                           │
  2392. │IC            Inserting control and graphics  characters                     │
  2393. │CONV          Lower / upper case key conversion                              │
  2394. │EMPTY         Emptying a text register (free more memory space)              │
  2395. │MOUSE         Mouse support                                                  │
  2396. │                                                                             │
  2397. │                                                                             │
  2398. │Enter the word on the left for help on above topics:                         │
  2399. ╘═════════════════════════════════════════════════════════════════════════════╛
  2400.  
  2401.  
  2402. The  screen  lists  topics  on  which  additional  help  information  is
  2403. available.  To select a topic, simply enter its name. 
  2404.  
  2405. For example, to display information about the status line,  type  "stat"
  2406. (in upper or lowercase) and press <Enter>.  You should get a result like
  2407. this:
  2408.  
  2409. ╒══════════════════════════════ Keyboard Help ════════════════════════════════╕
  2410. │BLOCK          Indicates that both block markers have been set. The block    │
  2411. │               can be processed from the {BLOCK} menu or printed from the    │
  2412. │               {PRINT} menu. The block markers can be removed (cancelled)    │
  2413. │               by pressing [CANCEL].                                         │
  2414. │                                                                             │
  2415. │C-N-S          On the IBM PC, the status of the Caps/Num/Scroll Lock is      │
  2416. │               displayed on the status line with the single letters "C", "N" │
  2417. │               and "S".                                                      │
  2418. │                                                                             │
  2419. │COL:           Indicates in which column of the text the cursor is located.  │
  2420. │               When the screen is scrolled sideways, the "COL" changes to    │
  2421. │               the column number corresponding to the left side of the       │
  2422. │               screen. E.g. "40:112" indicates the left screen edge is at    │
  2423. │               column 40 and the cursor is in column 112.                    │
  2424. │                                                                             │
  2425. │DISK           Indicates that the disk is full. This requires immediate      │
  2426. │               attention since the file currently cannot be saved to disk.   │
  2427. │               Use {MISC, DOS Shell} to enter DOS and delete some unnecessary│
  2428. │Press any key to continue                                                    │
  2429. ╘═════════════════════════════════════════════════════════════════════════════╛
  2430.  
  2431.  
  2432. Printing Text
  2433. -------------
  2434.  
  2435. You  can  print  the  text  you  have just created.  Make sure that your
  2436. printer is properly connected and "ON LINE".  Press  <F10>  and  "P"  to
  2437. enter the {Print} menu:
  2438.  
  2439.  
  2440.                                    40
  2441.  
  2442.  
  2443. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2444.  
  2445.  
  2446.      File  Edit  Block  Goto  Misc  Print  Search  Config  Help
  2447.                                     ╒══════════════╕
  2448.                                     │ All          │
  2449.                                     │ Block     ^P │
  2450.                                     │ Finish/Eject │
  2451.                                     │ Eject        │
  2452.                                     │ Reset        │
  2453.                                     │<Config       │
  2454.                                     ╘══════════════╛
  2455.  
  2456.  
  2457. This  is  a good time to try out the context sensitive help.  Press <F1>
  2458. (the [HELP] function).  A pop-up window will give a short description of
  2459. each item in the {PRINT} menu. 
  2460.  
  2461. Select {PRINT, All} to print the entire file.  After the text  is  fully
  2462. printed, the printer will advance to the beginning of the next page. 
  2463.  
  2464. Notice  that  the  text started a few lines down on the page and was not
  2465. printed on the left edge of the paper, but rather has about a  one  inch
  2466. margin.   The  description  of the {PRINT, Config} sub-menu in Chapter 6
  2467. (Menu Reference) explains how to configure various printing options. 
  2468.  
  2469.  
  2470. Repeating Operations
  2471. --------------------
  2472.  
  2473. It is often desirable to repeat an editing operation such  as  inserting
  2474. the  same  character,  or  deleting  many  lines.  By using the [REPEAT]
  2475. function (<Ctrl-R>), you can perform these operations a specified number
  2476. of times without having to press the same key over and over again. 
  2477.  
  2478. For example, if you needed to enter 50 "*" characters  into  your  text,
  2479. you  could press the "*" key fifty times, counting very carefully.  With
  2480. VEDIT Jr., there is a better way the [REPEAT] function  is  perfect  for
  2481. this. 
  2482.  
  2483. EXAMPLE - To enter 50 "*" characters into your text:
  2484.  
  2485.   1.  Press <Ctrl-R> (the [REPEAT] function).  The status line will
  2486.       prompt you with:
  2487.  
  2488.           Repeat count: 4
  2489.  
  2490.   2.  Type "50" and press <Enter>.  The status line now prompts:
  2491.  
  2492.           Press key to repeat:
  2493.  
  2494.   3.  Press "*".  Fifty "*" characters will be entered into your text. 
  2495.  
  2496. At  the "Repeat count" you can enter any number up to 256.  You can also
  2497. press [REPEAT] several more times to quadruple the initial value of 4 to
  2498. 16, then 64 and finally 256. 
  2499.  
  2500.  
  2501.                                    41
  2502.  
  2503.  
  2504. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2505.  
  2506.  
  2507. After the repeat count is entered, you can  press  any  text  character,
  2508. perform  any  editing  function  such  as [ERASE LINE], or make any menu
  2509. selection. 
  2510.  
  2511. For example, to delete 75 lines, press <Ctrl-R>.  At  the  prompt  enter
  2512. "75".  Then press <Ctrl-Y> (the [ERASE LINE] function). 
  2513.  
  2514. You can also repeat the last editing operation by pressing [REPEAT LAST]
  2515. (<Alt-R>).   Each  successive  [REPEAT  LAST]  repeats  the last editing
  2516. operation one more time. 
  2517.  
  2518. EXAMPLE - Toggle through all screen colors:
  2519.  
  2520.   1.  Select {MISC, Toggle Color}.  (Press <Alt-M> and then "C".)
  2521.       The screen color should change. 
  2522.  
  2523.   2.  Repeatedly press <Alt-R> (the [REPEAT LAST] function)
  2524.       to toggle through all screen colors. 
  2525.  
  2526. VEDIT Jr. also lets you repeatedly perform a sequence of  editing  steps
  2527. over  and  over  again.  This is done using "keystroke macros" which are
  2528. covered in Chapter 4 (Editing Guide) and Chapter 6 (Menu Reference). 
  2529.  
  2530.  
  2531. Saving Your Work
  2532. ----------------
  2533.  
  2534. You should periodically save your work back to disk.  You  can  do  this
  2535. using  VEDIT  Jr.'s  menu system.  The following example also introduces
  2536. you to two menu short cuts. 
  2537.  
  2538. To save your work to disk, first press <Alt-F> to get the  {FILE}  menu.
  2539. Then  press  "S"  for  "Save  and continue".  There may be a short delay
  2540. while your file is saved to  disk;  you  may  also  notice  the  message
  2541. "Please wait for disk" in the lower right corner of the screen. 
  2542.  
  2543. In  the  above  example you went directly to the {FILE} menu by pressing
  2544. the <Alt> key in combination with the first  letter  of  the  main  menu
  2545. item.  You can use this trick to go directly to any main menu item.  The
  2546. second short cut was to press the highlighted letter of the desired menu
  2547. item; this is usually the first letter. 
  2548.  
  2549.  
  2550. The "Escape" Menu
  2551. -----------------
  2552.  
  2553. The  {ESCAPE} menu is totally separate from the main menu.  This menu is
  2554. displayed when you press <Esc> and VEDIT Jr. does not know from what you
  2555. want to "escape". 
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.                                    42
  2563.  
  2564.  
  2565. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2566.  
  2567.  
  2568.   NEWS.TXT        LINE:    1   COL:   1                 INS             F1=HELP
  2569. ╒═════════════════════════════════════════════════════════════════════════════╕
  2570. │▓                                                                            │
  2571. │                                                                             │
  2572. │                        ╒══════════════════════╕                             │
  2573. │                        │     ESCAPE MENU      │                             │
  2574. │                        │ Remove block markers │                             │
  2575. │                        │ Exit file            │                             │
  2576. │                        ╘══════════════════════╛                             │
  2577. │                                                                             │
  2578. │                                                                             │
  2579. ╘═════════════════════════════════════════════════════════════════════════════╛
  2580.  
  2581.  
  2582. You select items from this menu using <Cursor Up> and <Cursor Down> just
  2583. as you do from other menus. 
  2584.  
  2585.  
  2586. Exiting VEDIT Jr. 
  2587. -----------------
  2588.  
  2589. To finish editing, simply press the <Esc> key to bring up  the  {ESCAPE}
  2590. menu.  Then select "Exit file". 
  2591.  
  2592. If  you  have  not  altered  the  current file, it will immediately exit
  2593. VEDIT.  Otherwise it will prompt you whether the changes to the  current
  2594. file should be saved or abandoned. 
  2595.  
  2596. To save your work and exit VEDIT Jr.:
  2597.  
  2598.   1.  Press <Esc> to bring up the {ESCAPE} menu. 
  2599.  
  2600.   2.  Press "E" to select "Exit file". 
  2601.  
  2602.   3.  At the prompt press "Y" to save and exit. 
  2603.  
  2604.  
  2605. Note  that  selecting  "Exit"  from  the  {ESCAPE}  menu is identical to
  2606. selecting "Exit" from the {FILE} menu. 
  2607.  
  2608.  
  2609. That's It! 
  2610. ----------
  2611.  
  2612. That's all you need to create and edit text files.  Obviously  there  is
  2613. much  more VEDIT Jr. can do for you.  For example, VEDIT Jr. can copy or
  2614. move blocks of text, search for and replace words or entire phrases  and
  2615. perform  numerous  other  operations.  Take some time to get comfortable
  2616. with basic editing, then read on  through  the  more  detailed  chapters
  2617. which follow. 
  2618.  
  2619. We certainly enjoyed creating VEDIT Jr. and sincerely hope it serves you
  2620. well. 
  2621.  
  2622.  
  2623.                                    43
  2624.  
  2625.  
  2626. VEDIT Jr.                      Chapter 3                  Quick Tutorial
  2627.  
  2628.  
  2629.                     This page is intentionally blank
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.                                    44
  2685.  
  2686.  
  2687. VEDIT Jr.                      Chapter 4                   Editing Guide
  2688.  
  2689.  
  2690. Chapter 4 - Editing Guide
  2691. ------------------------------------------------------------------------
  2692.  
  2693.  
  2694.                      Starting (Invoking) VEDIT Jr.
  2695.                      -----------------------------
  2696.  
  2697. Begin  editing  by  typing  the  name  of the VEDIT Jr. program; this is
  2698. normally "VJ".  Although not necessary, this is normally followed by the
  2699. name of the (first) file you want to edit or create.  For example:
  2700.  
  2701.         vj letter.txt
  2702.  
  2703. When creating a new file, the message "New file"  will  briefly  appear.
  2704. The filename on the status line at the top of the screen indicates which
  2705. file you are editing. 
  2706.  
  2707.  
  2708. Invocation Options
  2709. ------------------
  2710.  
  2711. The syntax for invoking VEDIT Jr. is:
  2712.  
  2713.     vj -options filename -a outfile
  2714.  
  2715. In  addition to the filename, one or more "options" can be specified (in
  2716. upper or lowercase) when you start up VEDIT Jr. 
  2717.  
  2718. -b          This puts VEDIT Jr. into "browse mode"; you can view  files,
  2719.             but  cannot  alter  them.   You also cannot create files nor
  2720.             write blocks to disk. 
  2721.  
  2722. -m          Causes  VEDIT Jr. to  use  screen   attributes   which   are
  2723.             appropriate for a monochrome (Black and White) monitor. 
  2724.  
  2725. -o          Causes  VEDIT Jr. to  write  to  the  screen  via the "BIOS"
  2726.             (instead of directly to the screen memory).  This  overrides
  2727.             the value set by configuration task 5.1.
  2728.  
  2729. -o1         Same as "-o". 
  2730.  
  2731. -o2         Causes  VEDIT Jr. to  write  to the screen via the "BIOS" on
  2732.             non-IBM type machines.  This is necessary  for  VEDIT Jr. to
  2733.             work on the Tandy 2000 and other "near" compatibles. 
  2734.  
  2735. -snnn       Restricts  VEDIT Jr. to  use  a  maximum  of 'nnn' Kbytes of
  2736.             memory for all data areas.  The minimum value is  30.   When
  2737.             'nnn'  is  not  specified,  "-s" defaults to (approximately)
  2738.             "64".  Without this option VEDIT Jr. may use  all  available
  2739.             memory. 
  2740.  
  2741. -nnn        Causes  VEDIT Jr. to start up on line 'nnn' of the file.  If
  2742.             there are fewer than 'nnn' lines in the file, it will  start
  2743.  
  2744.  
  2745.                                    45
  2746.  
  2747.  
  2748. VEDIT Jr.                      Chapter 4                   Editing Guide
  2749.  
  2750.  
  2751.             up  at  the end of the file.  You can also specify a numeric
  2752.             expression such as "-7890/3". 
  2753.  
  2754. --          Signals the end of the invocation  options.   This  is  only
  2755.             needed when the filename being edited begins with a "-". 
  2756.  
  2757. filename    The  name  of  the  file to edit.  All filenames may include
  2758.             full drive and path specifications. 
  2759.  
  2760. -a outfile  The  file  being  edited  will  be  saved  under  the   name
  2761.             'outfile'.   This  is  similar  to using the {FILE, Save as}
  2762.             function from within VEDIT Jr. 
  2763.  
  2764. To see a summary of all invocation options, give the command:
  2765.  
  2766.         vj /? 
  2767.  
  2768. Notes:
  2769.  
  2770.     "-m" is only needed if VEDIT Jr. was installed  (configured)  for  a
  2771.     color display and you have a monochrome display connected to a color
  2772.     (EGA/VGA) adapter. 
  2773.  
  2774.     The  "-s"  option  lets  you control how much memory VEDIT Jr. uses.
  2775.     The total memory used will be 'nnn' Kbytes  plus  the  size  of  the
  2776.     executable  VEDIT Jr. (approximately  64  Kbytes)  plus  another  10
  2777.     Kbytes.  "-s" can provide memory for  running  other  programs  from
  2778.     within  VEDIT Jr. using  {MISC, Dos shell}.  Otherwise VEDIT Jr. may
  2779.     use all available memory. 
  2780.  
  2781.     Values of less than 196 for the "-s" option will  limit  the  memory
  2782.     available for text register operations and the number of Undo levels
  2783.     available.   With  this  option,  or  with  little available memory,
  2784.     Vedit Jr. will be somewhat slower in editing large files. 
  2785.  
  2786. See Also:
  2787.  
  2788.     "Exiting VEDIT Jr."  and  "Backup  Files"  later  in  this  chapter.
  2789.     {MISC, DOS shell}, in Chapter 6 (Menu Reference). 
  2790.  
  2791. Examples:
  2792.  
  2793.     To  edit  the  file  "CONFIG.SYS" in the root directory of drive C:,
  2794.     type:
  2795.  
  2796.             vj c:\config.sys
  2797.  
  2798.     After you have modified and saved CONFIG.SYS, you will have both  an
  2799.     updated   copy  called  CONFIG.SYS  and  the  original  copy  called
  2800.     CONFIG.BAK. 
  2801.  
  2802.     To  edit  the  file  "PHONE.LST"  and  limit  the  memory  used   by
  2803.     VEDIT Jr. to 130 KBytes, type:
  2804.  
  2805.  
  2806.                                    46
  2807.  
  2808.  
  2809. VEDIT Jr.                      Chapter 4                   Editing Guide
  2810.  
  2811.  
  2812.             vj -s130 phone.lst
  2813.  
  2814.     To  edit  the  file "PROGRAM.C" and have the cursor start up on line
  2815.     984, give the command:
  2816.  
  2817.             vj -984 program.c
  2818.  
  2819.     To load the existing file "FAXSHEET.SAV", make  changes  to  it  and
  2820.     save it as the file "TOMJONES.292":
  2821.  
  2822.             vj faxsheet.sav -a tomjones.292
  2823.  
  2824.  
  2825. VEDIT Environment Variable
  2826. --------------------------
  2827.  
  2828.  
  2829. If  you use the same invocation options over and over again, you can set
  2830. up the environment variable "VEDIT" with any desired default options. 
  2831.  
  2832. For example, if you always wanted  VEDIT Jr. to  use  monochrome  screen
  2833. colors  and  to use a maximum of 196 Kbytes of data space, you could add
  2834. the following line to your AUTOEXEC.BAT file:
  2835.  
  2836.         SET VEDIT=-M -S196
  2837.  
  2838.  
  2839. Super-fast Browse Mode
  2840. ----------------------
  2841.  
  2842. Invoking VEDIT Jr. with the "-b" option causes files to be opened  in  a
  2843. special  and  very  fast "browse-only" mode.  {GOTO, Beginning of file},
  2844. {GOTO, End of file} and relative jumps using the mouse  will  then  work
  2845. instantly on even multi-megabyte files. 
  2846.  
  2847. Files  opened  in  browse-only  mode  are indicated with a "!" preceding
  2848. their filename on the status line. 
  2849.  
  2850. Since VEDIT Jr.  does not create  any  temporary  files  in  browse-only
  2851. mode, you can browse files on a read-only drive, such as a CD-ROM drive.
  2852.  
  2853. You  can also enable browse mode by selecting {FILE, Browse mode}.  This
  2854. disables additional changes to the current file and the next file opened
  2855. with {FILE, Open} will be opened in the special browse-only mode. 
  2856.  
  2857. Notes:
  2858.  
  2859.     CD-ROM  and  other  Read-only  files  are  automatically  opened  in
  2860.     browse-only mode. 
  2861.  
  2862.     VEDIT  does  not  always know the current line number when browsing;
  2863.     the line number is then displayed as "?????".  If you must know  the
  2864.     line  number  in  a browsed file, set {CONFIG, File handling, Enable
  2865.  
  2866.  
  2867.                                    47
  2868.  
  2869.  
  2870. VEDIT Jr.                      Chapter 4                   Editing Guide
  2871.  
  2872.  
  2873.     fast browse mode} to "No".  Browsing will be slower, but the correct
  2874.     line number will always be displayed. 
  2875.  
  2876.     You cannot disable browse mode if you invoked VEDIT with "-b". 
  2877.  
  2878.     To alter a file you are  currently  browsing,  select  {FILE,  New}.
  2879.     Then set {FILE, Browse mode} to "No".  Then open the same file again
  2880.     with {FILE, Open}. 
  2881.  
  2882.     See  {FILE,  Browse  mode} in Chapter 6 (Menu Reference) for related
  2883.     information. 
  2884.  
  2885.  
  2886.                              Exiting VEDIT Jr.
  2887.                              -----------------
  2888.  
  2889.     To exit VEDIT Jr. select either {FILE, Exit} or {ESCAPE, Exit file}.
  2890.     The "Exit" function is available in both  the  {FILE}  and  {ESCAPE}
  2891.     menus for convenience. 
  2892.  
  2893.     To exit VEDIT Jr. and save or abandon the current file:
  2894.  
  2895.     1.  Select either {FILE, Exit} or {ESCAPE, Exit file}. 
  2896.  
  2897.         If  no changes were made to the file since it was opened or last
  2898.         saved, VEDIT will immediately exit without any prompt. 
  2899.  
  2900.     2.  If the file has been changed, it will prompt with:
  2901.  
  2902.             Save the file <filename> ?  [Y]es [N]o-abandon [C]ancel
  2903.  
  2904.         Press "Y" to save the file and exit VEDIT.  Press "N" to abandon
  2905.         (not save) the changes and exit VEDIT.  Press "C" to cancel  the
  2906.         operation and return to your editing. 
  2907.  
  2908. Notes:
  2909.  
  2910.     If  there  is  insufficient  disk  space  to save the modified file,
  2911.     VEDIT Jr. displays an error and aborts the request to exit.  If this
  2912.     happens, you have several options.  You can  exit  and  abandon  any
  2913.     changes  made  or  delete unneeded files from your disk.  Or you can
  2914.     use {FILE, Save as} to save the file on another drive. 
  2915.  
  2916.     {MISC, DOS shell} and {MISC, Run DOS program} let  you  execute  DOS
  2917.     commands  for  deleting  files.   Be careful not to delete any files
  2918.     which start with  the  same  name  as  the  file  you  are  editing.
  2919.     VEDIT Jr. may be using these files for temporary storage. 
  2920.  
  2921. See Also:
  2922.  
  2923.     "Starting VEDIT Jr." earlier in this chapter. 
  2924.  
  2925.     {FILE, Exit} in Chapter 6 (Menu Reference). 
  2926.  
  2927.  
  2928.                                    48
  2929.  
  2930.  
  2931. VEDIT Jr.                      Chapter 4                   Editing Guide
  2932.  
  2933.  
  2934. Backup Files
  2935. ------------
  2936.  
  2937. When  you  edit  and  modify  an  existing  file,  VEDIT Jr. renames the
  2938. original file to the same name with a ".BAK" extension.   This  provides
  2939. an  automatic  backup  of  the original file contents should you need to
  2940. refer back to the original file.  Any existing ".BAK"  file  is  deleted
  2941. during this process. 
  2942.  
  2943. Backup  files  take  up additional disk space but provide important data
  2944. protection.  They provide a backup in case of a  major  editing  mistake
  2945. which  you  may  not  notice  until  days later.  They also provide some
  2946. protection against  accidentally  deleting  files  --  the  most  recent
  2947. revisions  may  be  lost,  but at least the previous revisions are still
  2948. there. 
  2949.  
  2950. When you are sure you do not need  the  backup  files  anymore  you  can
  2951. delete  them with the DOS command "DEL *.BAK".  (The "XDEL" command from
  2952. Digital Research's DR-DOS can delete all backup files in all directories
  2953. with the command "XDEL *.BAK /S".)
  2954.  
  2955. However, if you are  determined  not  to  have  VEDIT Jr. create  backup
  2956. files, this backup feature can be turned off. 
  2957.  
  2958. To turn off backup files:
  2959.  
  2960.     1.  Set {CONFIG, File handling, Enable backup} to "Off". 
  2961.  
  2962.     2.  To  make this change permanent in VEDIT Jr. select {CONFIG, Save
  2963.         into VEDIT}. 
  2964.  
  2965.  
  2966.                             The Status Line
  2967.                             ---------------
  2968.  
  2969. VEDIT Jr. provides a wide variety of information on  the  "Status  Line"
  2970. located at the top of the screen. 
  2971.  
  2972. Additional  status  information  is available by selecting the menu item
  2973. {HELP, Status display}. 
  2974.  
  2975. The Status Line may include the following information:
  2976.  
  2977.  
  2978. BLOCK       Indicates that  both  block  markers  have  been  set.   The
  2979.             highlighted  block  can  be processed with the {BLOCK} menu,
  2980.             printed  with  {PRINT,  Block}  and  indented/undented  with
  2981.             [INDENT]  and [UNDENT].  The block markers can be removed by
  2982.             pressing [CANCEL] (<Ctrl-C>). 
  2983.  
  2984. C-N-S       On the IBM PC (DOS only), the status of the  Caps/Num/Scroll
  2985.             Lock is displayed on the status line with the single letters
  2986.             "C", "N" and "S". 
  2987.  
  2988.  
  2989.                                    49
  2990.  
  2991.  
  2992. VEDIT Jr.                      Chapter 4                   Editing Guide
  2993.  
  2994.  
  2995. COL: xxxx   Indicates  in  which column of the text the cursor is.  When
  2996.             the screen is scrolled sideways, the "COL"  changes  to  the
  2997.             column  number corresponding to the left side of the screen.
  2998.             E.g. "40:112" indicates the left screen edge is at column 40
  2999.             and the cursor is in column 112. 
  3000.  
  3001. Disk        The disk is full!  This requires immediate  attention  since
  3002.             the  file  currently cannot be saved to disk.  See the topic
  3003.             "Exiting  VEDIT Jr."  earlier  in  this  chapter  for   more
  3004.             information. 
  3005.  
  3006. filename    Indicates  the  name  of the file you are currently editing.
  3007.             This may include a drive ID if the file being edited is  not
  3008.             on the current drive.  Use {HELP, Status display} to display
  3009.             the full pathname of the file and its size. 
  3010.  
  3011.             The  filename  is preceded with "!" when the file was opened
  3012.             in browse-only mode.  The file cannot be altered, but can be
  3013.             quickly browsed. 
  3014.  
  3015. INS         "Insert" mode is on; if this is not displayed,  VEDIT Jr. is
  3016.             in "Overstrike" mode. 
  3017.  
  3018. LINE: xxxx  Indicates  on  what  line  of  the  file the cursor is.  The
  3019.             message is reduced to "LI:" for line  numbers  greater  than
  3020.             65535.   When  the  message  is  all  in capital letters the
  3021.             entire file is memory.  Otherwise the message  is  displayed
  3022.             as follows:
  3023.  
  3024. Line:       The  beginning  of  the file is currently in memory, but the
  3025.             end of the file is on disk. 
  3026.  
  3027. lINE:       The end  of  the  file  is  currently  in  memory,  but  the
  3028.             beginning of the file has been written to disk. 
  3029.  
  3030. line:       Only  the  middle of the file is in memory, the remainder is
  3031.             on disk. 
  3032.  
  3033. RM: xx      Right margin value -- only displayed if the right margin  is
  3034.             set. 
  3035.  
  3036. TEXT        Indicates  that  you  have  text  in the text register.  The
  3037.             "BLOCK" and "1-END" messages have higher  priority  and  may
  3038.             appear in its place. 
  3039.  
  3040. 1-END       Indicates  that  only one block marker is set.  The block of
  3041.             text is highlighted as  you  move  the  cursor.   The  block
  3042.             marker can be removed by pressing [CANCEL] (<Ctrl-C>). 
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.                                    50
  3051.  
  3052.  
  3053. VEDIT Jr.                      Chapter 4                   Editing Guide
  3054.  
  3055.  
  3056. Examples:
  3057.  
  3058. B:NEWS.TXT     LINE:   1  COL:  1               INS     N         F1=HELP
  3059.  
  3060.     The  status  line  above indicates that the file "NEWS.TXT" is being
  3061.     edited on drive "B:", the cursor is at the beginning  of  the  file,
  3062.     "Insert  Mode"  is  on,  the  "Numlock"  status is on and the [HELP]
  3063.     function is assigned to <F1>. 
  3064.  
  3065. ACCOUNT.RPT    Line: 233  40:  62        1-END         CN     Alt-F1=Help
  3066.  
  3067.     The status line above shows that "ACCOUNT.RPT" on the default  drive
  3068.     is  being  edited, only the first part of the file is in memory, the
  3069.     cursor is located at line 233 and column 62, the screen is  scrolled
  3070.     40  columns to the right (the left most displayed column is actually
  3071.     column 40), the first (and not the  second)  block  marker  is  set,
  3072.     "CapsLock"  and "Numlock" are on and the [HELP] function is assigned
  3073.     to <Alt-F1>. 
  3074.  
  3075.  
  3076.                               Using Menus
  3077.                               -----------
  3078.  
  3079. VEDIT Jr.'s menu system  provides  convenient  access  to  many  editing
  3080. functions which complement the basic "edit functions".  It also lets you
  3081. access  most  configurable  parameters and additional help and reference
  3082. information. 
  3083.  
  3084. You can access the items in the menu system in three ways:
  3085.  
  3086. *  Bring up the menu system by pressing [MENU] (<F10>).   You  can  then
  3087.    navigate  through  the available functions with the cursor keys; then
  3088.    press <Enter> to select the highlighted item.   If  the  item  is  an
  3089.    editing  function,  it  is then performed; if the item is a sub-menu,
  3090.    that sub-menu is selected. 
  3091.  
  3092. *  Directly access the desired sub-menu by  pressing  the  corresponding
  3093.    "hot  key".   On an IBM PC (DOS) the "normal" keyboard layout defines
  3094.    <Alt-x>, where "x" is the first letter of each  main  sub-menu.   For
  3095.    example,  <Alt-B> accesses the {BLOCK} sub-menu.  You can then select
  3096.    menu items in the normal fashion. 
  3097.  
  3098. *  Directly  access  the  desired  editing  function  by  pressing   its
  3099.    corresponding  "hot-key".   In this case the menus are not displayed;
  3100.    the selected editing function is  immediately  performed.   The  menu
  3101.    system displays the currently available "hot-key" for each menu item.
  3102.    As  you learn them you will be able to edit faster.  You can also add
  3103.    "hot-keys" for additional menu functions that you  want  to  directly
  3104.    access. 
  3105.  
  3106. The  menu  system  is straight forward in operation and similar to other
  3107. menu systems.  However, there are several special features you should be
  3108. aware of:
  3109.  
  3110.  
  3111.                                    51
  3112.  
  3113.  
  3114. VEDIT Jr.                      Chapter 4                   Editing Guide
  3115.  
  3116.  
  3117. Sub-menus are displayed before they are selected; this lets you  preview
  3118.    the  items  in  the  sub-menu.   Therefore,  after  selecting  [MENU]
  3119.    (<F10>), both the top menu bar and the {FILE} sub-menu are displayed.
  3120.    However, since the {FILE} sub-menu is not yet selected, pressing  "S"
  3121.    selects the {SEARCH} sub-menu and not {FILE, Save and continue}. 
  3122.  
  3123.     Although we think that this sub-menu preview feature is very useful,
  3124.     you can disable it. 
  3125.  
  3126. *  <Space Bar> highlights the next item in the main menu and sub-menus. 
  3127.  
  3128. *  You  can  also select by typing the highlighted letter of the desired
  3129.    menu item.  This is often, but not always, the first letter  of  that
  3130.    item.   This  technique  MUST  be used when defining keystroke macros
  3131.    (i.e. "hot keys"). 
  3132.  
  3133. *  When entering a sub-menu with <Enter> or the <Alt-x>  technique,  the
  3134.    initially  highlighted  item  is  the  last  selected  item  in  that
  3135.    sub-menu. 
  3136.  
  3137. *  You can also enter sub-menus from the main  menu  with  [CURSOR DOWN]
  3138.    and  [CURSOR UP] which then highlight the first and last items in the
  3139.    sub-menu, respectively. 
  3140.  
  3141. *  Even  after  you  have  entered   a   sub-menu,   [CURSOR LEFT]   and
  3142.    [CURSOR RIGHT]  will  pop  you  back  to the main menu and select the
  3143.    previous/next sub-menu. 
  3144.  
  3145. To directly exit from any  menu  or  parameter  prompt,  press  [CANCEL]
  3146. (<Ctrl-C>).   The  [CANCEL] function aborts any menu selection or prompt
  3147. and returns the editor back to normal editing.  If you only want to back
  3148. up to a previous menu level, press <Esc>.  Pressing <Esc> from the  main
  3149. menu will exit the menu system and return you to normal editing. 
  3150.  
  3151. VEDIT Jr. displays  the  special {ESCAPE} menu when <Esc> is pressed and
  3152. there is no pending operation from which  to  "escape".   This  "Escape"
  3153. menu can be used to cancel block markers or to exit VEDIT Jr. 
  3154.  
  3155. Context  sensitive help is available from within the menu system.  While
  3156. a menu is displayed, press [HELP] (<F1>).  The information will  contain
  3157. a short description of each item in the current menu. 
  3158.  
  3159. Notes:
  3160.  
  3161.     If  you  cannot  read the menus, cannot tell which item is currently
  3162.     selected, or cannot tell which letter in each item  is  highlighted,
  3163.     your  screen  attributes  are  not  set  correctly.   If  you have a
  3164.     monochrome (black and white) monitor or a Laptop  computer  you  may
  3165.     need  to  re-install  VEDIT Jr. for a monochrome monitor or start up
  3166.     VEDIT Jr. with the "-M" option.  Otherwise use {CONFIG,  Colors}  to
  3167.     change  the  colors  used  by VEDIT Jr. to ones compatible with your
  3168.     computer. 
  3169.  
  3170.  
  3171.  
  3172.                                    52
  3173.  
  3174.  
  3175. VEDIT Jr.                      Chapter 4                   Editing Guide
  3176.  
  3177.  
  3178.     There is some overlap between the basic  "edit  functions"  and  the
  3179.     editing  functions  found  in  the menu system.  For example, {EDIT,
  3180.     Erase line} is the same as [ERASE LINE], and {SEARCH, Search} is the
  3181.     same as [SEARCH].  This overlap helps new users and lets you  access
  3182.     edit functions with a mouse. 
  3183.  
  3184.     As  a  convenience,  the  menu system remembers the most recent path
  3185.     taken.  This way you can simply press [MENU] followed by <Enter> two
  3186.     or more times to select the same menu item again. 
  3187.  
  3188.     As described on the previous page, VEDIT previews  sub-menus  before
  3189.     they  are  selected.   This is visually a little different from most
  3190.     other menu systems.  Although this does not  change  the  keystrokes
  3191.     needed  to  select  a  menu  item, it sometimes confuses a new user.
  3192.     This feature can be turned off by setting {CONFIG,  Screen  display,
  3193.     Enable sub-menu preview} to "No".  However, as is customary in other
  3194.     software, sub-menus are always previewed when using a mouse. 
  3195.  
  3196. Examples:
  3197.  
  3198. To select "Status Display":
  3199.  
  3200.     1.  Press [HELP] (<F1>). 
  3201.  
  3202.     2.  Highlight "Help" using the Cursor keys; press <Enter>. 
  3203.  
  3204.     3.  Highlight "Status display" using the Cursor keys; press <Enter>.
  3205.  
  3206. To change the screen color:
  3207.  
  3208.     1.  Press <Alt-M> as a shortcut to the {MISC} sub-menu. 
  3209.  
  3210.     2.  Press "C" to perform "Color toggle". 
  3211.  
  3212. To repeat the above operation:
  3213.  
  3214.         Press [MENU] <Enter> <Enter>. 
  3215.  
  3216. -OR-
  3217.  
  3218.         Press [REPEAT LAST] (<Alt-R>). 
  3219.  
  3220. To exit VEDIT Jr.:
  3221.  
  3222.     1.  Press [ESCAPE] to access the {ESCAPE} menu. 
  3223.  
  3224.     2.  Press "E" to select "Exit". 
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.                                    53
  3234.  
  3235.  
  3236. VEDIT Jr.                      Chapter 4                   Editing Guide
  3237.  
  3238.  
  3239.                          Responding to Prompts
  3240.                          ---------------------
  3241.  
  3242. When VEDIT Jr. needs to prompt you for additional information, such as a
  3243. filename,  it uses a pop-up "dialog" box.  You can edit your response as
  3244. you enter it. 
  3245.  
  3246. VEDIT Jr. maintains a "history" of the responses you enter at each  type
  3247. of prompt.  You can recall and reuse, or edit these previous responses. 
  3248.  
  3249. The following edit keys may be used while entering a response:
  3250.  
  3251. [CURSOR UP]     Recall Previous Response. 
  3252.  
  3253. [CURSOR DOWN]   Recall later response. 
  3254.  
  3255. [CURSOR LEFT]   Move cursor one character to the left. 
  3256.  
  3257. [CURSOR RIGHT]  Move cursor one character to the right. 
  3258.  
  3259. [LINE BEGIN]    Move the cursor to the beginning of the response. 
  3260.  
  3261. [LINE END]      Move the cursor to the end of the response. 
  3262.  
  3263. [DELETE]        Erase the character under the cursor. 
  3264.  
  3265. [BACKSPACE]     Erase the character to the left of the cursor. 
  3266.  
  3267. [ERASE LINE]    Erase the current response. 
  3268.  
  3269. [ESCAPE]        Cancel  the  operation  for  which  the  information was
  3270.                 requested. 
  3271.  
  3272. Notes:
  3273.  
  3274.     Responses are always entered in "Insert" mode.  It is  not  possible
  3275.     to change to Overstrike mode. 
  3276.  
  3277.     After  editing a line, it is not necessary to move the cursor to the
  3278.     end of the line before pressing <Enter>. 
  3279.  
  3280.     Some prompts request only a single character.  You respond to  these
  3281.     simply  by  pressing  the  desired  character.   Do  not follow your
  3282.     response with <Enter>. 
  3283.  
  3284. Examples:
  3285.  
  3286.     To insert two  files  with  similar  name,  say  "TEXTFILE.001"  and
  3287.     "TEXTFILE.002":
  3288.  
  3289.         Select {EDIT, Insert file} and type "TEXTFILE.001" and <Enter>. 
  3290.  
  3291.         Select   {EDIT,  Insert  file}  again;  press  [CURSOR UP];  use
  3292.  
  3293.  
  3294.                                    54
  3295.  
  3296.  
  3297. VEDIT Jr.                      Chapter 4                   Editing Guide
  3298.  
  3299.  
  3300.         [BACKSPACE] to edit the file and then press <Enter>. 
  3301.  
  3302.  
  3303.                      Point and Shoot File Selection
  3304.                      ------------------------------
  3305.  
  3306. Since   it   is   often   difficult   to   remember   exact   filenames,
  3307. VEDIT Jr. features point & shoot file selection. 
  3308.  
  3309. For  any  editing  function  which  requires  a filename, such as {FILE,
  3310. Open}, VEDIT Jr. will first prompt you for the filename:
  3311.  
  3312.         Enter filename:
  3313.  
  3314. If you know the exact filename you can simply enter it.   Alternatively,
  3315. you  can press <Enter> to have VEDIT Jr. give you a display of all files
  3316. in the current directory.  Or you  can  enter  a  "filespec"  using  the
  3317. "wildcard"  characters  "*"  and  "?"  to  have  VEDIT Jr. only  display
  3318. selected files.  The format of the "filespec" is identical to that  used
  3319. for the DOS "DIR" command. 
  3320.  
  3321. A typical point & shoot display might be:
  3322.  
  3323. ╒══════════════════════════════════════════════════════════════════════╕
  3324. │ C:\VDOC\VEDJR\*.*                                                    │
  3325. │ ..            TEMP\         EXAMPLES\     PRINTALL.BAT  CHAPTER1.CAP │
  3326. │ CHAPTER2.CAP  CHAPTER3.CAP  LAYOUT.CAP    CHAPTER1.CHP  CHAPTER2.CHP │
  3327. │ CHAPTER3.CHP  CHAPTER4.CHP  CHAPTER5.CHP  CHAPTER6.CHP  CHAPTER7.CHP │
  3328. │ CHAPTER8.CHP  CHAPTERX.CHP  LAYOUT.CHP    VED-HEAD.CHP  VED-TOC.CHP  │
  3329. │ CHAPTER1.CIF  CHAPTER2.CIF  CHAPTER3.CIF  CHAPTER4.CIF  CHAPTER5.CIF │
  3330. │ CHAPTER6.CIF  CHAPTER7.CIF  CHAPTER8.CIF  CHAPTERX.CIF  LAYOUT.CIF   │
  3331. │ VED-HEAD.CIF  VED-TOC.CIF   VEDITTOC.GEN  VEDIT.INI     VEDITMAN.PUB │
  3332. │ CHAPTER6.SAV  VED-HEAD.STY  VEDMAN.STY    CHAPTER1.TXT  CHAPTER2.TXT │
  3333. │ CHAPTER3.TXT  CHAPTER4.TXT  CHAPTER5.TXT  CHAPTER6.TXT  CHAPTER7.TXT │
  3334. ╘══════════════════════════════════════════════════════════════════════╛
  3335.  
  3336. The  top  line  displays the current "filespec" including the full drive
  3337. and pathname. 
  3338.  
  3339. To select a file from the point & shoot window:
  3340.  
  3341.     1.  Use the cursor keys to highlight the desired file. 
  3342.  
  3343.     2.  When there are many files, [PAGE UP] and [PAGE DOWN] may help in
  3344.         viewing the files; [LINE END] (<End>) highlights the  last  file
  3345.         and [LINE BEGIN] (<Home>) highlights the first file. 
  3346.  
  3347.     3.  Press <Enter> to select the highlighted file. 
  3348.  
  3349.     4.  Selecting  the  special  first filename ".." moves up in the DOS
  3350.         directory structure.  Any directories are displayed before other
  3351.         filenames and are indicated with a following "\".   Selecting  a
  3352.         directory   moves  down  in  the  directory  structure  to  that
  3353.  
  3354.  
  3355.                                    55
  3356.  
  3357.  
  3358. VEDIT Jr.                      Chapter 4                   Editing Guide
  3359.  
  3360.  
  3361.         directory. 
  3362.  
  3363. You can change the "filespec" from within the point & shoot window. 
  3364.  
  3365. To change the point & shoot "filespec":
  3366.  
  3367.     1.  Press the <Tab> key (the [TAB CHARACTER] function).  The  cursor
  3368.         will move just past the current filespec. 
  3369.  
  3370.     2.  Edit  the  filespec  as  desired.   Remember  that  you  can use
  3371.         [CURSOR UP] to recall previous filespecs. 
  3372.  
  3373.     3.  Press <Enter> when  the  filespec  is  correct.   VEDIT Jr. will
  3374.         display a new set of files with the first one highlighted. 
  3375.  
  3376.     Press  [ESCAPE]  or  [CANCEL] (<Ctrl-C>) to cancel the point & shoot
  3377.     operation. 
  3378.  
  3379. Notes:
  3380.  
  3381.     To access files on a different drive you must change the "filespec".
  3382.  
  3383.     Changing to a different drive or directory during the point &  shoot
  3384.     does   not  cause  the  next  file  selection  to  default  to  that
  3385.     drive/directory.  To change the default drive/directory, use  {FILE,
  3386.     Directory}. 
  3387.  
  3388.  
  3389.                               On-Line Help
  3390.                               ------------
  3391.  
  3392. Help  information  may be requested at any time by pressing [HELP].  The
  3393. keystroke assigned to [HELP] is always displayed at the right end of the
  3394. status line. 
  3395.  
  3396. VEDIT Jr.'s help system is "Context Sensitive", which means that it will
  3397. display information which is relevant to the task at hand.  For example,
  3398. during normal editing, requesting help displays general  information  on
  3399. key  assignments and basic operations.  If you request help while a menu
  3400. or prompt is displayed, information on that particular  menu  or  prompt
  3401. will be provided. 
  3402.  
  3403. The "General" help information is divided into three pages:
  3404.  
  3405. 1.  Keystrokes Assigned to Edit Functions
  3406.  
  3407.     This  is  a  list  of  all  edit  functions  and  the keys which are
  3408.     currently assigned to them.  When this page is  displayed,  you  can
  3409.     press  a  listed  keystroke to display additional information on the
  3410.     associated edit function. 
  3411.  
  3412. 2.  Keystrokes Assigned to Built-In Keystroke Macros
  3413.  
  3414.  
  3415.  
  3416.                                    56
  3417.  
  3418.  
  3419. VEDIT Jr.                      Chapter 4                   Editing Guide
  3420.  
  3421.  
  3422.     VEDIT Jr.'s "normal" keyboard layout  includes  numerous  "Built-In"
  3423.     keystroke  macros.   This  page summarizes these macros and displays
  3424.     the keystrokes to which they are assigned.  There is  no  additional
  3425.     on-line help available for these macros. 
  3426.  
  3427. 3.  Help Topics
  3428.  
  3429.     This  page  is  a  list  of  assorted  topics  on  which  additional
  3430.     information is available.  You  can  select  the  desired  topic  by
  3431.     entering the key word listed on the left. 
  3432.  
  3433. Notes:
  3434.  
  3435.     Pressing  [HELP] during normal editing (i.e. no menus or prompts are
  3436.     up) is the same as selecting {HELP, General}. 
  3437.  
  3438.     All help information is contained in the  file  VJHELP.HLP.   It  is
  3439.     usually   located   in   the   "VEDIT   Home  Directory"  (typically
  3440.     "C:\vedit"). 
  3441.  
  3442.     The help system's  display  of  the  edit  function  assignments  is
  3443.     dynamic -- it reflects any changes you may have made to the keyboard
  3444.     layout.   However,  the  summary  of the keystroke macros is static;
  3445.     this summary is listed at the beginning of the VJHELP.HLP file.   It
  3446.     is  only  applicable to the "normal" keyboard layout and will not be
  3447.     correct if you have an alternative keyboard  layout.   However,  you
  3448.     can edit VJHELP.HLP as desired. 
  3449.  
  3450. See Also:
  3451.  
  3452.     The  {HELP}  menu  and {MISC, Keyboard layout} sub-menu in Chapter 6
  3453.     (Menu Reference). 
  3454.  
  3455.  
  3456. Modifying the Help File
  3457. -----------------------
  3458.  
  3459. VEDIT Jr.'s help file VJHELP.HLP is a standard text file which is easily
  3460. changed and/or expanded.  You should find  it  very  easy  to  edit  the
  3461. beginning of this file which lists a summary of the keystroke macros. 
  3462.  
  3463. The  following  is  a  technical description of how the help file works.
  3464. This information is only necessary if you want to make major changes  to
  3465. the  file.  This discussion is easier to understand if you are examining
  3466. the file VJHELP.HLP within VEDIT Jr. and are familiar with the operation
  3467. of the on-line help. 
  3468.  
  3469. The help file uses three control characters:
  3470.  
  3471. <Ctrl-L>  Clears the help window
  3472.  
  3473. <Ctrl-S>  Displays the message following the <Ctrl-S> on the  bottom  of
  3474.           the  screen  and waits for the user to press <Enter>.  It then
  3475.  
  3476.  
  3477.                                    57
  3478.  
  3479.  
  3480. VEDIT Jr.                      Chapter 4                   Editing Guide
  3481.  
  3482.  
  3483.           continues with the text on the following lines. 
  3484.  
  3485. <Ctrl-V>  Displays the prompt "Press key for desired function or <Enter>
  3486.           for next screen:".  The  next  key  pressed  by  the  user  is
  3487.           decoded  as  an  edit function and converted into a two-letter
  3488.           "edit function code".  It then searches the remainder  of  the
  3489.           file  for  the  string "\edit-function-code\" and displays the
  3490.           text starting on the following line. 
  3491.  
  3492. For example, [CURSOR UP] is  converted  to  the  code  "\CU\".   If  you
  3493. examine  VJHELP.HLP,  you will notice that the help text for [CURSOR UP]
  3494. is preceded with "\CU\". 
  3495.  
  3496. <Enter> (the [RETURN] function) is converted to the  code  "\RT\".   You
  3497. will  notice  that  <Ctrl-V>  is  usually  followed  with "\RT\" -- this
  3498. defines what the "next screen" is. 
  3499.  
  3500. You  can  examine  the  VJHELP.HLP  file  to  see  what   all   of   the
  3501. edit-function-codes are. 
  3502.  
  3503. The  end  of  VJHELP.HLP  includes additional topics, beginning with the
  3504. code "\BL\", which are directly accessed by context sensitive help.  The
  3505. text for these topics can also be altered. 
  3506.  
  3507.  
  3508.                              Mouse Support
  3509.                              -------------
  3510.  
  3511. The mouse support makes it easy to navigate and  select  from  the  menu
  3512. system.  You can also quickly scroll to other parts of the file, perform
  3513. block operations, switch between windows and access on-line help. 
  3514.  
  3515. If  you  have a mouse and it is active, the mouse cursor will by default
  3516. remain invisible in the upper left corner of the screen.  It will become
  3517. visible when you move the mouse out of the  corner.   You  can  make  it
  3518. invisible again by moving it back to its corner. 
  3519.  
  3520. {CONFIG, Misc, Mouse Cursor} controls the mouse support.  A value of "0"
  3521. disables  the  mouse support.  The default value of "1" starts the mouse
  3522. cursor in the upper left hand corner where it is initially  "invisible".
  3523. This is the preferred value for experienced users.  "2" starts the mouse
  3524. cursor  in  the  middle  of  the  screen.   This  reminds new users that
  3525. VEDIT Jr. has mouse support. 
  3526.  
  3527. The mouse support is fully described in the on-line help. 
  3528.  
  3529. To access on-line help for mouse support:
  3530.  
  3531.     1.  Press [HELP] (<F1>). 
  3532.  
  3533.     2.  At the prompt "Press key for desired function..." click the left
  3534.         mouse button. 
  3535.  
  3536.  
  3537.  
  3538.                                    58
  3539.  
  3540.  
  3541. VEDIT Jr.                      Chapter 4                   Editing Guide
  3542.  
  3543.  
  3544. -OR-
  3545.  
  3546.     2.  Press <Enter> twice to see the "Help Topics" and enter "mouse". 
  3547.  
  3548. NOTE:  For the mouse  to  work  within  VEDIT Jr.,  you  must  have  the
  3549.        appropriate  mouse  driver  installed in memory.  This is usually
  3550.        done  by  loading  "MOUSE.SYS"  in  your  CONFIG.SYS   file,   or
  3551.        "MOUSE.COM"  in  your  AUTOEXEC.BAT  file.  Be sure the Microsoft
  3552.        mouse driver is version 6.24  or  later,  or  that  the  Logitech
  3553.        driver  is  version  4.15  or later.  Older mouse drivers may not
  3554.        support the VGA 50 line mode.  VEDIT Jr. uses only  two  buttons;
  3555.        the middle button on a 3-button mouse is inactive. 
  3556.  
  3557.  
  3558. Scroll Bars
  3559. -----------
  3560.  
  3561. The installation lets you select whether or not scroll bars are enabled.
  3562. The  scroll  bars  work  according  to the IBM SAA/CUA standard, as with
  3563. Microsoft Windows and most other programs.  Even if  you  don't  have  a
  3564. mouse,  you  may find scroll bars useful because they show your relative
  3565. position in the file. 
  3566.  
  3567. Scroll bars can be enabled/disabled with {CONFIG, Screen display, Enable
  3568. scroll bars}. 
  3569.  
  3570. The mouse support is fully functional with or without scroll  bars.   Of
  3571. course,  using  the  mouse  is  more  intuitive  when  scroll  bars  are
  3572. displayed.  When scroll bars are not displayed,  the  right  button  can
  3573. access "stealth" scroll bars described below. 
  3574.  
  3575. Standard  scroll  bar  functions  are  available through use of the left
  3576. button. 
  3577.  
  3578. The vertical scroll bar indicates your  position  with  respect  to  the
  3579. entire file.  The horizontal scroll bar indicates how much the screen is
  3580. scrolled  sideways with respect to 1000 columns.  You you can edit lines
  3581. longer than 1000 characters; however, the scroll bar slider will  remain
  3582. in the rightmost position. 
  3583.  
  3584. Clicking  an arrow scrolls in the indicated direction.  Holding down the
  3585. left button scrolls continuously. 
  3586.  
  3587. Clicking on the vertical scroll bar above or below the "slider" performs
  3588. a [PAGE UP] or [PAGE DOWN] respectively.  You can also drag  the  slider
  3589. in  order  to quickly jump to a relative position in the file.  This may
  3590. take some time in multi-megabyte files, but will be nearly instantaneous
  3591. in fast "browse" mode. 
  3592.  
  3593. Clicking on the horizontal scroll bar  to  the  left  or  right  of  the
  3594. "slider"   performs   a  [SCROLL LEFT]  or  [SCROLL RIGHT]  respectively
  3595. (typically 20 columns).  You can  also  drag  the  slider  in  order  to
  3596. quickly scroll the screen sideways up to 1000 columns. 
  3597.  
  3598.  
  3599.                                    59
  3600.  
  3601.  
  3602. VEDIT Jr.                      Chapter 4                   Editing Guide
  3603.  
  3604.  
  3605. "Stealth" Scroll Bars and the Right Button
  3606. ------------------------------------------
  3607.  
  3608. The right button performs useful (and non-standard) mouse operations. 
  3609.  
  3610. When  scroll  bars  are  enabled, the right button can also access them.
  3611. When scroll bars are disabled, the rightmost window column is considered
  3612. a "stealth" scroll bar, just as if  it  were  visible.   Similarly,  the
  3613. bottom window line is the stealth horizontal scroll bar. 
  3614.  
  3615. Clicking  the  right  button  on real or "stealth" arrows scrolls in the
  3616. desired direction.  Clicking anywhere on a real or  stealth  scroll  bar
  3617. immediately jumps to the relative position. 
  3618.  
  3619. To  make  quick  jumps  within  the file, move the mouse to the relative
  3620. position on the real/stealth vertical scroll bar  and  click  the  right
  3621. button.   (Unless  you  are in fast browse-only mode, this may take some
  3622. time in multi-megabyte files!)
  3623.  
  3624. To [PAGE UP] move the mouse to the four rightmost  columns  of  the  top
  3625. line,  not  including  the  real/stealth scroll bar, and click the right
  3626. button. 
  3627.  
  3628. To [PAGE DOWN] move the mouse to  the  four  rightmost  columns  of  the
  3629. bottom  line,  not  including the real/stealth scroll bar, and click the
  3630. right button. 
  3631.  
  3632. You can also [SCROLL UP] / [SCROLL DOWN] by moving the mouse anywhere in
  3633. the top/bottom half of the window, respectively, and holding  the  right
  3634. button  as  long  as  desired.   Moving  the  mouse further to the right
  3635. scrolls the screen faster. 
  3636.  
  3637. NOTE:  This is a very convenient way to scroll at varying speeds. 
  3638.  
  3639. In summary, the right button responds to these regions of the window:
  3640.  
  3641. ╒════════════════════════════════════════════════╕
  3642. │                                           PgUp^│
  3643. │               Scroll Up                       ▒│
  3644. │(Slow ....................................Fast)▒│
  3645. │                                               ▒│
  3646. │                                               ▒│
  3647. │                                               ▒│
  3648. │                                               ▒│
  3649. │                                               ▒│
  3650. │               Scroll Down                     ▒│
  3651. │                                           PgDnv│
  3652. │<▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒> │
  3653. ╘════════════════════════════════════════════════╛
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.                                    60
  3661.  
  3662.  
  3663. VEDIT Jr.                      Chapter 4                   Editing Guide
  3664.  
  3665.  
  3666. Menu System
  3667. -----------
  3668.  
  3669. To access the menu system, move the mouse to the status line  and  click
  3670. the left button.  To access the {ESCAPE} menu, click the right button. 
  3671.  
  3672. Select  sub-menus and items by moving the mouse to them and clicking the
  3673. left button. 
  3674.  
  3675. To navigate the menu system, hold down the  left  button.   Sliding  the
  3676. mouse  along  the  top  screen line displays each sub-menu.  Sliding the
  3677. mouse up/down highlights each item or sub-sub-menu.  Placing  the  mouse
  3678. on an item and releasing the left button selects the item. 
  3679.  
  3680. To  escape  from  the menu system move the mouse off the menus (into the
  3681. text) and release the left button.  This is the same action as [CANCEL].
  3682.  
  3683. Pressing both mouse buttons also performs a [CANCEL].  The best  way  to
  3684. do  this  is  to  press  and  hold the left button; then click the right
  3685. button and release the left button. 
  3686.  
  3687. Clicking the right button within the menu system  accesses  the  on-line
  3688. help. 
  3689.  
  3690.  
  3691. Block Operation
  3692. ---------------
  3693.  
  3694. To move the editing cursor to the mouse position, click the left button.
  3695.  
  3696. To  highlight  a  block  of text, simply drag the mouse over the desired
  3697. block of text with the left button held down. 
  3698.  
  3699. HINTS:  To highlight a small block, move the mouse to  the  desired  1st
  3700.         position.   Press  and  hold the left button.  Drag the mouse to
  3701.         the 2nd position -- the  highlighting  will  follow  the  mouse.
  3702.         Release the left button.  This sets both block markers. 
  3703.  
  3704.         To  highlight  a block larger than the screen, move the mouse to
  3705.         the desired 1st position.  Press and hold the left button.  Drag
  3706.         the mouse to another  character  and  then  back  again  to  the
  3707.         original  position.  Release the left button; this only sets the
  3708.         1st block marker.   Then  page  to  the  desired  2nd  position.
  3709.         Finish  highlighting,  by  pressing,  dragging and releasing the
  3710.         left button.  Both block markers are now set. 
  3711.  
  3712. To copy a block, first highlight the block, setting both markers.   Move
  3713. the  mouse  to the position for inserting the block.  While holding down
  3714. the <Ctrl> key, click the left button. 
  3715.  
  3716. Moving a block is similar, except that you hold down the <Alt>  key  and
  3717. click the left button. 
  3718.  
  3719.  
  3720.  
  3721.                                    61
  3722.  
  3723.  
  3724. VEDIT Jr.                      Chapter 4                   Editing Guide
  3725.  
  3726.  
  3727. Search/Replace Options
  3728. ----------------------
  3729.  
  3730. The  top  line  of the dialog box for the Search/Replace functions reads
  3731. "Press [SEARCH] or [REPLACE] for options"; when possible,  the  function
  3732. names  are  replaced with the names of the assigned keys.  To access the
  3733. search options move the mouse to  this  top  line  and  click  the  left
  3734. button.  A small dialog box will pop up. 
  3735.  
  3736. To  select  individual  search  options  move the mouse to the selection
  3737. letter (the letter inside square brackets) and click  the  left  button.
  3738. When  all  options are selected, position the mouse anywhere else in the
  3739. dialog box and click the left button. 
  3740.  
  3741.  
  3742. Notes on Mouse Operation
  3743. ------------------------
  3744.  
  3745. VEDIT's simple dialog boxes display selections in square brackets,  i.e.
  3746. "[Y]es [N]o".  You can answer these by moving the mouse to the selection
  3747. letter (or the bracket) and clicking the left button. 
  3748.  
  3749. When normal prompts are on the screen, the left button acts identical to
  3750. the  <Enter>  key  (when the mouse cursor is not on top of a selection).
  3751. Therefore, the prompt "Press any key to continue" is satisfied by moving
  3752. the mouse anywhere in the window containing the prompt and clicking  the
  3753. left button. 
  3754.  
  3755. When  prompts  and  menus  are  on  the  screen,  the  right button acts
  3756. identical to the [HELP] key and supplies context sensitive help. 
  3757.  
  3758. Pressing both buttons together always performs  a  [CANCEL],  cancelling
  3759. any  current  operation.   During normal editing, this removes any block
  3760. markers. 
  3761.  
  3762. To make the mouse cursor invisible, move it to the top left hand  corner
  3763. of  the screen.  This is useful when the mouse driver is loaded, but you
  3764. don't want to use the mouse.  Or set {CONFIG,  Misc,  Mouse  cursor}  to
  3765. "0". 
  3766.  
  3767.  
  3768.                   Screen Display & Keyboard Characters
  3769.                   ------------------------------------
  3770.  
  3771. VEDIT  lets  you  display  control  and  graphics  characters in several
  3772. different ways. 
  3773.  
  3774. During editing, all displayable characters such as letters,  digits  and
  3775. punctuation  are  entered  directly  into  the  text, while function and
  3776. control keys are interpreted as basic "edit functions" or as  "keystroke
  3777. macros". 
  3778.  
  3779. VEDIT Jr. allows   complete   flexibility  in  determining  the  desired
  3780.  
  3781.  
  3782.                                    62
  3783.  
  3784.  
  3785. VEDIT Jr.                      Chapter 4                   Editing Guide
  3786.  
  3787.  
  3788. keyboard layout.  You  can  assign  the  basic  edit  functions  to  any
  3789. function  and  control  keys,  and  build  in  as  many keystroke macros
  3790. ("hot-keys") as desired. 
  3791.  
  3792. Function and  control  keys  which  are  not  assigned  to  either  edit
  3793. functions or keystroke macros are usually ignored. 
  3794.  
  3795. Entering Control and Graphics Characters
  3796. ----------------------------------------
  3797.  
  3798. There  are 256 possible characters on any computer.  (A computer's basic
  3799. memory unit called a "byte" allows 256 possible values).  The  first  32
  3800. characters  are  called  "control  characters" and have decimal values 0
  3801. through 31 .  The normal displayable characters have decimal  values  32
  3802. through  127.   The characters with values of 128 through 255 are called
  3803. "graphics characters" or "high bit characters". 
  3804.  
  3805. To enter a control character into your text, you must  precede  it  with
  3806. [ENTER CTRL]  (<Ctrl-Q>).   This  technique  also lets you enter control
  3807. characters into search strings.  [ENTER CTRL] is fully  described  under
  3808. the equivalent {EDIT, Enter CTRL char} in Chapter 6 (Menu Reference). 
  3809.  
  3810. On  the  IBM  PC, graphics characters can be entered directly by holding
  3811. down the  <Alt>  key  and  typing  the  decimal  value  of  the  desired
  3812. character.   All character values except "00" (the "null" character) can
  3813. be entered in this way. 
  3814.  
  3815. You can enter the "null" character by pressing  [ENTER CTRL]  (<Ctrl-Q>)
  3816. and then <Ctrl-2>. 
  3817.  
  3818. Alternatively,  you  can enter control and graphics characters into your
  3819. file using {MISC, ASCII table}. 
  3820.  
  3821.  
  3822. How Control and Graphics Characters are Displayed
  3823. -------------------------------------------------
  3824.  
  3825. Most control characters are normally displayed as a "^" followed by  the
  3826. corresponding  letter,  i.e.  <Ctrl-G> displays as "^G".  Alternatively,
  3827. control characters can be displayed literally (i.e. the  "smiling  face"
  3828. on an IBM PC).  This is described below. 
  3829.  
  3830. Graphics   characters   are   normally   displayed  literally,  but  can
  3831. alternatively be displayed as a decimal value in the format "<nnn>". 
  3832.  
  3833. <Ctrl-I> the Tab character is normally displayed as spaces to  the  next
  3834. tab  stop.   Alternatively,  the Tab character can be displayed with any
  3835. other character by setting the configuration parameter  {CONFIG,  Screen
  3836. display, Tab display character}. 
  3837.  
  3838. <Ctrl-J>  the  Line-Feed character always ends a line of text and is the
  3839. true "newline" character  at  the  end  of  each  line.   The  "newline"
  3840. character  is  normally  displayed  as  a  space,  effectively making it
  3841.  
  3842.  
  3843.                                    63
  3844.  
  3845.  
  3846. VEDIT Jr.                      Chapter 4                   Editing Guide
  3847.  
  3848.  
  3849. invisible.  Alternatively, a visible "newline" character can  be  chosen
  3850. with {CONFIG, Screen display, Newline display character}.  With DOS text
  3851. files,  a Line-Feed not preceded by the normal Carriage-return character
  3852. is displayed as "<LF>". 
  3853.  
  3854. <Ctrl-M> the Carriage-Return character normally occurs just  before  the
  3855. Line-Feed  in  DOS text files; in this case it is considered part of the
  3856. "newline" and not displayed.  Otherwise, a Carriage-Return character  is
  3857. displayed as "<CR>". 
  3858.  
  3859.  
  3860. Display Modes
  3861. -------------
  3862.  
  3863. The  configuration  parameter  {CONFIG,  Screen  display, Screen display
  3864. options} determines how control and graphics characters are displayed. 
  3865.  
  3866. Although this parameter has eight possible values, these five values are
  3867. the most useful:
  3868.  
  3869. 0   Display graphics and control characters literally. 
  3870.  
  3871. 1   (Default) Display graphics character literally, but display  control
  3872.     characters in the "^x" format. 
  3873.  
  3874. 2   Display control character literally, but display graphics characters
  3875.     as decimal values in the format "<nnn>". 
  3876.  
  3877. 3   Display  graphics  characters  in  the  "<nnn>"  format  and control
  3878.     characters in the "^x" format. 
  3879.  
  3880. 4   Display all characters literally, including <Tab>, <CR> and <LF>. 
  3881.  
  3882.  
  3883. End of Line Handling (DOS and UNIX)
  3884. -----------------------------------
  3885.  
  3886. The   configuration   parameter   {CONFIG,   File   handling,    Newline
  3887. character(s)}  determines  whether  VEDIT Jr. expects normal DOS or UNIX
  3888. type text files.  It determines how "newline" characters are  displayed,
  3889. deleted  and  inserted.   By  setting this parameter you can easily edit
  3890. UNIX files under DOS. 
  3891.  
  3892. Each line in a DOS text file normally ends in both a Carriage-Return and
  3893. Line-Feed character; this  "<CR><LF>"  pair  is  considered  the  normal
  3894. "newline"  character  even though it really is two characters.  Pressing
  3895. [DELETE]  once  at  the  end  of  a  line  deletes  the  <CR><LF>  pair.
  3896. Similarly, pressing <Enter> (in Insert Mode) inserts a <CR><LF> pair.>
  3897.  
  3898. If  a  line  in  a  DOS  text  file  ends in just a Line-Feed, "<LF>" is
  3899. displayed at the end of the line.  Such  a  line  may  be  corrected  by
  3900. deleting  the  line  <LF>  with [DELETE] and then inserting the <CR><LF>
  3901. pair with <Enter>. 
  3902.  
  3903.  
  3904.                                    64
  3905.  
  3906.  
  3907. VEDIT Jr.                      Chapter 4                   Editing Guide
  3908.  
  3909.  
  3910. UNIX text files normally have  lines  ending  in  in  just  a  Line-Feed
  3911. character,  which  is therefore the "newline".  Pressing <Enter> inserts
  3912. only  the  Line-Feed  character.   Carriage-Return  characters  have  no
  3913. special meaning and are displayed as "<CR>". 
  3914.  
  3915. VEDIT Jr. does  not  automatically  convert  a  DOS file to UNIX or vice
  3916. versa.  However, this can be done with a search and replace operation. 
  3917.  
  3918. To convert a DOS file into a UNIX file:
  3919.  
  3920.     1.  Go to the beginning of the file with {GOTO, Beginning of file}. 
  3921.  
  3922.     2.  Press [REPLACE] (<Alt-F2>). 
  3923.  
  3924.     3.  Enter the following search and replacement strings:
  3925.  
  3926.             Search?  <CR><LF>
  3927.             Replace with?  <LF>
  3928.  
  3929.         Enter the "<CR><LF>"" search string by pressing <Ctrl-N>.  Enter
  3930.         the "<LF>" by first pressing [ENTER CTRL]  (<Ctrl-Q>)  and  then
  3931.         pressing <Ctrl-J>. 
  3932.  
  3933.     4.  At  the replacement prompt press "R" to replace all occurrences.
  3934.         The file is now converted. 
  3935.  
  3936. To convert a UNIX file into a DOS file:
  3937.  
  3938.     1.  Go to the beginning of the file with {GOTO, Beginning of file}. 
  3939.  
  3940.     2.  Press [REPLACE] (<Alt-F2>). 
  3941.  
  3942.     3.  Enter the following search and replacement strings:
  3943.  
  3944.             Search?  <LF>
  3945.             Replace with?  <CR><LF>
  3946.  
  3947.         Enter the "<LF>" search string by  first  pressing  [ENTER CTRL]
  3948.         (<Ctrl-Q>)  and then pressing <Ctrl-J>.  Enter the "<CR><LF>" by
  3949.         pressing [ENTER CTRL],  then  <Ctrl-J>,  then  [ENTER CTRL]  and
  3950.         <Enter>.  (Then press <Enter> again.)
  3951.  
  3952.     4.  At  the replacement prompt press "R" to replace all occurrences.
  3953.         The file is now converted. 
  3954.  
  3955.  
  3956. The <Tab> Key and Tab Characters
  3957. --------------------------------
  3958.  
  3959. The <Tab> key  is  identical  to  <Ctrl-I>  and  is  almost  universally
  3960. assigned to the [TAB CHARACTER] function. 
  3961.  
  3962. In  "Insert"  mode the <Tab> key normally inserts a "Tab" character into
  3963.  
  3964.  
  3965.                                    65
  3966.  
  3967.  
  3968. VEDIT Jr.                      Chapter 4                   Editing Guide
  3969.  
  3970.  
  3971. the text.  Tab characters are displayed using spaces up to the next  tab
  3972. stop,  even  though  these  spaces  do  not  exist  in  the  text.  As a
  3973. convenience, you do not have to be in Insert Mode to insert text on  top
  3974. of a Tab character.  The Tab character will not be overwritten until you
  3975. reach its last displayed position. 
  3976.  
  3977. Because  of  the importance of the <Tab> key and Tab characters, several
  3978. configuration options are available:
  3979.  
  3980. *  The tab stops are normally set to every eighth  column,  but  can  be
  3981.    changed  with  {CONFIG,  Tab  stops}.   Tab  stops  can be set at any
  3982.    desired columns, e.g. at 7, 20, 30  and  73.   Tab  characters  which
  3983.    occur  past  the  last  tab  stop  are  displayed  as  normal control
  3984.    characters, i.e "^I". 
  3985.  
  3986. *  Instead of displaying Tab characters using  spaces,  you  can  select
  3987.    another   character   with   {CONFIG,  Screen  display,  Tab  display
  3988.    character}.  A suitable value on an IBM PC is "07".  This can make it
  3989.    easier to distinguish between Tab characters and spaces in your file.
  3990.  
  3991. *  VEDIT Jr. can be configured to insert multiple spaces (up to the next
  3992.    tab stop) instead of a Tab character when <Tab> is pressed.  Although
  3993.    this uses more disk space, it is useful  in  applications  where  tab
  3994.    stops  outside  of  VEDIT Jr. will  not  be the same as those inside.
  3995.    This option is also handy with  FORTRAN  and  COBOL  programs.   This
  3996.    option  is  selected  with  {CONFIG, Emulation, Expand <Tab> key with
  3997.    spaces}. 
  3998.  
  3999. *  The operation of the <Tab> and <Enter> keys normally depend upon  the
  4000.    "Insert"   mode.   This  can  be  changed  with  {CONFIG,  Emulation,
  4001.    Typewriter emulation mode}. 
  4002.  
  4003.  
  4004. Lower and Upper Case Conversion
  4005. -------------------------------
  4006.  
  4007. This topic is primarily applicable to programmers, particularly assembly
  4008. language programmers. 
  4009.  
  4010. Several modes are available for converting between lower and upper  case
  4011. letters  as  they  are  typed on the keyboard.  These modes are selected
  4012. with  the  parameter  {CONFIG,   Programming,   Lower/upper   case   key
  4013. conversion}, which can take on four values:
  4014.  
  4015. 0      No conversion takes place.  This is the default. 
  4016.  
  4017. 1      All  lower  case  letters  are  converted to upper case.  This is
  4018.        similar to the "Caps Lock" on a keyboard. 
  4019.  
  4020. 2      Conditional conversion -- lower case  letters  are  converted  to
  4021.        upper  case  only  when the cursor is to left of the "Conditional
  4022.        conversion character". 
  4023.  
  4024.  
  4025.  
  4026.                                    66
  4027.  
  4028.  
  4029. VEDIT Jr.                      Chapter 4                   Editing Guide
  4030.  
  4031.  
  4032. 3      Similar to (2) except that characters  are  reversed  instead  of
  4033.        being forced to upper case. 
  4034.  
  4035. Modes  "2"  and  "3"  are  specifically  designed  for assembly language
  4036. programmers that prefer having the Label, Opcode and  Operand  in  upper
  4037. case and the comment in upper and lower case. 
  4038.  
  4039. In Mode "2" lower case letters are converted to upper case if they occur
  4040. to  the  left  of the "conditional conversion character", typically ";".
  4041. To the right of the ";"  they  are  not  converted.   In  this  mode  an
  4042. assembly  language  program can be entered or edited with all lower case
  4043. letters and VEDIT Jr. will automatically convert the labels, opcodes and
  4044. operands to upper case while leaving  the  comment  fields  alone.   The
  4045. "conditional   conversion   character"  may  be  changed  with  {CONFIG,
  4046. Programming, Conditional conversion character}. 
  4047.  
  4048. Mode "3" is similar to Mode "2"; instead of  converting  lower  case  to
  4049. upper  case,  it  reverses the case of letters appearing before the ";".
  4050. This makes it easier to enter lower case strings into  a  program  (hold
  4051. down the shift key to enter lower case letters). 
  4052.  
  4053. NOTE:  This  upper/lower  case  conversion  option  does  not affect any
  4054.        existing text; use {EDIT, Lower/Upper case} to  convert  existing
  4055.        text. 
  4056.  
  4057.  
  4058. Key Emulation Modes
  4059. -------------------
  4060.  
  4061. Not only can you assign the basic edit functions to any desired function
  4062. or control keys, but you can change how the commonly used edit functions
  4063. work.   This  lets  you emulate other editors and word processors and/or
  4064. fine tune VEDIT Jr. to your preferences.  The "emulation modes"  can  be
  4065. changed with the {CONFIG, Emulation} sub-menu.  They are fully described
  4066. in Chapter 6 (Menu Reference). 
  4067.  
  4068. The emulation modes include:
  4069.  
  4070. *  Cursor  positioning  modes  --  control  how the cursor keys move the
  4071.    cursor past the ends of lines. 
  4072.  
  4073. *  Typewriter emulation modes -- control how the <Tab> and <Enter>  keys
  4074.    work in "Insert" and "Overstrike" modes. 
  4075.  
  4076. *  Line  emulation  mode -- controls how the [LINE BEGIN] and [LINE END]
  4077.    functions (<Home> and <End> keys) work when the cursor is already  at
  4078.    the beginning/end of the line. 
  4079.  
  4080. *  Special   emulation   modes   --  controls  how  the  [SCREEN BEGIN],
  4081.    [SCREEN END],  [SCROLL UP],  [SCROLL DOWN],  [SEARCH],  [DELETE]  and
  4082.    [BACKSPACE] functions work. 
  4083.  
  4084. A  little  experimentation  is  best  for  understanding these modes and
  4085.  
  4086.  
  4087.                                    67
  4088.  
  4089.  
  4090. VEDIT Jr.                      Chapter 4                   Editing Guide
  4091.  
  4092.  
  4093. deciding which you like best.  The on-line help describes these modes in
  4094. more detail; select the  {CONFIG,  Emulation}  sub-menu  and  press  the
  4095. [HELP] (<F1>) key. 
  4096.  
  4097. More  sophisticated emulation can be performed with the use of keystroke
  4098. macros. 
  4099.  
  4100.  
  4101. Other Keyboard Input Options (Technical)
  4102. ----------------------------------------
  4103.  
  4104. Configuration parameter 2.6 (Chapter 8) controls whether VEDIT Jr. reads
  4105. the IBM PC keyboard via "ROM BIOS" or "DOS".  When  set  to  "ROM  BIOS"
  4106. (default),  keyboard  enhancers,  such  as  Borland's Superkey (tm), are
  4107. bypassed and have no effect on VEDIT Jr.'s operation; set to "DOS", they
  4108. affect operation (which may be desirable or undesirable). 
  4109.  
  4110. The parameter {CONFIG, Misc, Keyboard input  options}  controls  several
  4111. rarely changed options:
  4112.  
  4113. *   The  "8th" bit can be enabled or stripped when reading the keyboard;
  4114.     you always want it enabled on an IBM PC.   Note  that  this  has  no
  4115.     effect on 8-bit characters already in the text.  Such characters are
  4116.     left unmodified when they are read from disk or written to disk. 
  4117.  
  4118. *   8-bit characters are normally treated as text (graphics) characters.
  4119.     Alternatively,  they  can  be  treated as as function keys.  This is
  4120.     usually not desirable on an IBM PC. 
  4121.  
  4122. *   Unassigned function/control keys can enter their codes directly into
  4123.     the text. 
  4124.  
  4125. *   The case of all letters can be flipped e.g. typing "a" gives you "A"
  4126.     and typing "A" gives you "a".  (We are  not  exactly  sure  why  you
  4127.     would want this, but VEDIT has always had this capability.)
  4128.  
  4129.  
  4130. Other Screen Display Issues (Technical)
  4131. ---------------------------------------
  4132.  
  4133. On  the IBM PC, you can select from seven different cursor types -- four
  4134. "software" cursors and three "system" cursors.   VEDIT Jr. is  typically
  4135. configured  to  have  a  different  cursor appearance in "Insert" versus
  4136. "Overstrike" mode.  For the software cursors, you can select  the  blink
  4137. rate  or  a  non-blinking  cursor  and a specific cursor color.  For the
  4138. system cursors, you can choose a thin,  medium  or  full-height  cursor.
  4139. These  options  are  a  matter of personal preference and are configured
  4140. with the {CONFIG, Misc} sub-menu. 
  4141.  
  4142. VEDIT Jr. will interrupt screen updates when you  are  performing  rapid
  4143. screen  changes.   Operations  such  as [PAGE DOWN] require updating the
  4144. entire screen.  If you press another [PAGE DOWN]  while  the  screen  is
  4145. updating,  VEDIT Jr. interrupts  the  unwanted  update  and  restarts to
  4146.  
  4147.  
  4148.                                    68
  4149.  
  4150.  
  4151. VEDIT Jr.                      Chapter 4                   Editing Guide
  4152.  
  4153.  
  4154. display the most current screen.  You are most likely to notice this  if
  4155. you hold down the [PAGE DOWN] key. 
  4156.  
  4157.  
  4158.                             Keystroke Macros
  4159.                             ----------------
  4160.  
  4161. In  order  to  use VEDIT Jr. effectively and streamline your own editing
  4162. tasks it is important to  understand  VEDIT Jr.'s  extensive  "keystroke
  4163. macro" facilities. 
  4164.  
  4165. VEDIT Jr. can remember a sequence of keystrokes and repeatedly play them
  4166. back at the press of a key.  These stored keystroke sequences are called
  4167. "keystroke  macros".  They let you assign a frequently typed sequence of
  4168. keys to a single function or control key.  You can  define  a  virtually
  4169. unlimited  number of keystroke macros and each may contain up to several
  4170. hundred keystrokes. 
  4171.  
  4172. Each keystroke macro is normally assigned to a function or  control  key
  4173. that  is  not  already in use (examples might be <Ctrl-F5>, <Ctrl-W> and
  4174. <Alt-J>).  Pressing the single function or control key then performs the
  4175. equivalent of typing the entire sequence of keys.  This saves you  time,
  4176. effort and reduces the chance of error. 
  4177.  
  4178. You  can use keystroke macros to repeatedly execute almost any operation
  4179. or sequence of operations.   This  includes  selecting  items  from  the
  4180. menus, responding to VEDIT Jr. prompts as well as simply typing text. 
  4181.  
  4182. Keystroke macros have several purposes:
  4183.  
  4184. *  The most common use of keystroke macros is as "hot-keys" for directly
  4185.    accessing  items  within  the  menu system.  Many such "hot-keys" are
  4186.    built into the "normal" and other  supplied  keyboard  layouts.   The
  4187.    menus display any "hot-keys" which directly access each item. 
  4188.  
  4189. *  Since  new  keystroke macros can easily be added at any time, you can
  4190.    define one whenever you find yourself typing the same  sequence  over
  4191.    and  over  again.   For example, you could define the key <Ctrl-A> to
  4192.    type out the whole phrase "attached and included herein by reference"
  4193.    each time it was pressed. 
  4194.  
  4195. You can add new keystroke macros at any time.  {MISC,  Keyboard  layout,
  4196. Add  keystroke  macro} lets you define a new keystroke macro and edit it
  4197. as you enter it.  Alternatively, {MISC, Keyboard layout,  Record  macro}
  4198. lets  you  record  a  new keystroke macro while you edit your file.  See
  4199. these functions in Chapter 6 (Menu Reference) for more details. 
  4200.  
  4201. NOTE:  VEDIT Jr. forgets new keystroke macros when you exit  unless  you
  4202.        make them permanent with {CONFIG, Save into VEDIT}. 
  4203.  
  4204. Example - Adding a new keystroke macro
  4205.  
  4206.     In  this  example,  will  define  <Ctrl-F1> to enable justification.
  4207.  
  4208.  
  4209.                                    69
  4210.  
  4211.  
  4212. VEDIT Jr.                      Chapter 4                   Editing Guide
  4213.  
  4214.  
  4215.     (You could also define <Ctrl-F2> to disable it.)
  4216.  
  4217.     1.  Select {MISC, Keyboard layout, Record macro} (or press <Alt-K>).
  4218.         You will see the following dialog box:
  4219.  
  4220.     ╒══════════════════════════════════════════════════════════════════╕
  4221.     │ Press <Backspace> to edit; <Esc> to enter                        │
  4222.     │ Function/Control Key?                                            │
  4223.     ╘══════════════════════════════════════════════════════════════════╛
  4224.  
  4225.  
  4226.     2.  At the prompt, press <Ctrl-F1>.  If you make  a  mistake,  press
  4227.         [BACKSPACE]  to delete the keystroke.  Now press <Esc> to accept
  4228.         <Ctrl-F1>. 
  4229.  
  4230.         You are now in "Record Mode" as displayed on the status line. 
  4231.  
  4232.     3.  Justification is enabled by setting  {CONFIG,  Word  processing,
  4233.         Justify  paragraphs}  to  "1".   Therefore,  press the following
  4234.         sequence of keys: (assumes  <F10>  is  [MENU]  and  <Ctrl-C>  is
  4235.         [CANCEL])
  4236.  
  4237.                  <F10> C W J 1 <Enter> <Ctrl-C>
  4238.  
  4239.         (This  keystroke  macro  ends  in [CANCEL] to exit from the menu
  4240.         system; in general, keystroke macros do not end in [CANCEL].)
  4241.  
  4242.         Turn off the Record Mode by pressing <Alt-K>.  The key  to  turn
  4243.         off (stop) Record Mode is displayed on the status line.  The new
  4244.         keystroke macro is now fully defined. 
  4245.  
  4246. Notes:
  4247.  
  4248.     The  function  {MISC,  Keyboard layout, Display layout} displays all
  4249.     active keystroke macros.  The <Ctrl-F1> defined in the example above
  4250.     would display as:
  4251.  
  4252.         Ctrl-F1    [MENU]CWJ1[RETURN][CANCEL]
  4253.  
  4254.     VEDIT Jr. records the edit functions in a keystroke  macro  and  not
  4255.     the  function and control keys that were pressed.  This ensures that
  4256.     keystroke macros are independent of the keyboard layout --  you  can
  4257.     change  the  keyboard  layout  without  having  to  reenter existing
  4258.     keystroke macros. 
  4259.  
  4260.     You can get a printout of the entire keyboard  layout  or  just  the
  4261.     keystroke macros by selecting {MISC, Keyboard layout, Print layout}.
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.                                    70
  4271.  
  4272.  
  4273. VEDIT Jr.                      Chapter 4                   Editing Guide
  4274.  
  4275.  
  4276.                           Scrolling the Screen
  4277.                           --------------------
  4278.  
  4279. The  screen  can  be thought of as a "window" into a much larger area of
  4280. text.  Certainly this  larger  area  can  extend  above  and  below  the
  4281. currently  visible  text.   However, if the text is logically wider than
  4282. the actual screen width, it can also extend to the right or left of  the
  4283. visible  text.  The areas of text which are not currently visible can be
  4284. exposed by "scrolling" the  display  over  to  those  areas.   Scrolling
  4285. happens naturally when entering new text as the older text "scrolls" off
  4286. the screen. 
  4287.  
  4288.  
  4289. Vertical Scrolling
  4290. ------------------
  4291.  
  4292. The screen scrolls automatically as the cursor is moved towards the very
  4293. top  or  bottom of the screen.  As delivered, VEDIT Jr. will scroll when
  4294. the cursor reaches about the third line from the top or  bottom  of  the
  4295. screen.   This  ensures that you always see a few lines before and after
  4296. the line you are editing. 
  4297.  
  4298. You  can  also  use  [SCROLL UP]  (<Ctrl-Up Arrow>)  and   [SCROLL DOWN]
  4299. (<Ctrl-Down Arrow>)  to  scroll  the  screen  without having to move the
  4300. cursor.  This allows you to view lines which are just off the screen. 
  4301.  
  4302. The configuration program VCONFIG (Chapter 8) lets you select  how  many
  4303. lines  of overlap you will see when using [PAGE UP] and [PAGE DOWN], and
  4304. how close to the top/bottom of the screen the cursor can get before  the
  4305. screen scrolls. 
  4306.  
  4307.  
  4308. Horizontal Scrolling
  4309. --------------------
  4310.  
  4311. VEDIT Jr. can scroll the the screen sideways for editing documents which
  4312. are wider than the display, such as spreadsheets or structured programs.
  4313. Similar  to  vertical scrolling, the screen automatically scrolls as the
  4314. cursor is moved toward the beginning or end of long lines.  You can also
  4315. scroll  the  screen  horizontally  without  moving  the   cursor   using
  4316. [SCROLL RIGHT]       (<Ctrl-Cursor Right>)       and       [SCROLL LEFT]
  4317. (<Ctrl-Cursor Left>). 
  4318.  
  4319. When scrolling sideways, the screen normally jumps by 20  columns  at  a
  4320. time.   If  desired,  this  can  be  changed  with  {CONFIG,  Emulation,
  4321. Horizontal scroll increment}. 
  4322.  
  4323. When editing extremely long lines, you can quickly move  the  cursor  to
  4324. any desired column with {GOTO, Column #}. 
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.                                    71
  4332.  
  4333.  
  4334. VEDIT Jr.                      Chapter 4                   Editing Guide
  4335.  
  4336.  
  4337. Wrapping Long Lines on the Screen
  4338. ---------------------------------
  4339.  
  4340. Long   lines   normally  extend  off  the  right  side  of  the  screen.
  4341. Alternatively, you can have them wrap onto multiple screen lines.   This
  4342. lets you see an entire long line at once. 
  4343.  
  4344. To wrap long text lines onto multiple screen lines:
  4345.  
  4346.     1.  Select {CONFIG, Emulation, Horizontal scroll margin}. 
  4347.  
  4348.     2.  At the prompt enter a new value of "79". 
  4349.  
  4350. The "horizontal scroll margin" (independent of the word processing right
  4351. margin) determines at which column VEDIT Jr. wraps long lines. 
  4352.  
  4353. Lines  longer  than the horizontal scroll margin are wrapped to the next
  4354. screen  (window)  line.   These  additional  screen  lines  are   called
  4355. "continuation  lines"  and  are  indicated  with a special "continuation
  4356. character", typically a reverse video "-" (dash) in the leftmost column.
  4357. The continuation character can be changed with the configuration program
  4358. VCONFIG (Chapter 8). 
  4359.  
  4360. When the horizontal  scroll  margin  is  set,  the  leftmost  column  is
  4361. reserved   for  the  continuation  character  --  lines  which  are  not
  4362. continuation lines have a space in the first column.  Therefore only  79
  4363. characters  can  be  displayed  per  screen  line (assuming 80 character
  4364. width); that is why "79" and  NOT  "80"  is  typically  chosen  for  the
  4365. horizontal scroll margin. 
  4366.  
  4367. The  horizontal  scroll  margin  can be set to values up to 255 which is
  4368. obviously wider than your screen.  In this case, only lines longer  than
  4369. the  scroll  margin and wrapped, and normal horizontal scrolling is used
  4370. to view columns up to the scroll margin.  Since continuation  lines  are
  4371. quite  obvious  on  the  screen,  this lets you flag lines longer than a
  4372. specified length, e.g. lines that are too long for your application. 
  4373.  
  4374. For example, your  compiler  may  not  support  lines  longer  than  132
  4375. characters.   In  this case, set the horizontal scroll margin to 132 and
  4376. any longer lines will be obvious on the screen. 
  4377.  
  4378. Notes:
  4379.  
  4380.     Setting the horizontal scroll margin slows down  screen  updates  by
  4381.     about 25% due to this feature's computational overhead. 
  4382.  
  4383.     To  reduce the amount of unwanted side to side scrolling, especially
  4384.     on CRT terminals, the [LINE END] function  can  be  configured  with
  4385.     {CONFIG,  Emulation,  Line  emulation mode} to only go to the end of
  4386.     the screen line instead of the end of the text line. 
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.                                    72
  4393.  
  4394.  
  4395. VEDIT Jr.                      Chapter 4                   Editing Guide
  4396.  
  4397.  
  4398.                             Block Operations
  4399.                             ----------------
  4400.  
  4401. One of the most useful features of VEDIT Jr. is  its  ability  to  copy,
  4402. move,  delete,  save  and  reuse  blocks  of text.  A "block" can be any
  4403. amount of text from one character to an entire file.   A  block  can  be
  4404. either  a group of contiguous characters called a "character block" or a
  4405. vertical column which extends down  through  the  middle  of  your  text
  4406. called a "columnar block". 
  4407.  
  4408. A  block  is  selected  (marked)  by setting beginning and ending "block
  4409. markers".  VEDIT Jr. highlights this area so you can see what  you  have
  4410. selected. 
  4411.  
  4412. Block  editing functions such as {BLOCK, Delete} are not available until
  4413. you have selected a block  of  text.   Items  which  are  not  currently
  4414. available  in the {BLOCK} menu are displayed in a different color and do
  4415. not have the "selection letter" highlighted. 
  4416.  
  4417. Selecting a block of text  not  only  lets  you  perform  block  editing
  4418. functions,  but  also  changes the operation of other editing functions.
  4419. For example, when the cursor is within a highlighted block of text,  the
  4420. [INDENT]   and   [UNDENT]  functions  indent/undent  the  entire  block;
  4421. otherwise these functions only change the current left margin. 
  4422.  
  4423.  
  4424. Marking (selecting) a Block of Text
  4425. -----------------------------------
  4426.  
  4427. The description for {BLOCK, Set marker} in Chapter  6  (Menu  Reference)
  4428. describes in detail how to mark a block of text. 
  4429.  
  4430. In  short,  move  the  cursor  to  the beginning of the block and select
  4431. {BLOCK, Set marker} (<F9>) to highlight a "character" block, or  {BLOCK,
  4432. Set  column  marker} (<Ctrl-N>) to highlight a "columnar" block.  As you
  4433. now move the cursor, intervening text will be highlighted. 
  4434.  
  4435. Many block operations including {BLOCK, Delete} and {PRINT,  Block}  can
  4436. be  performed  after  setting  only the first marker the cursor position
  4437. acts as the second marker.  However, if you need to or want to, you  can
  4438. set  the  second  block marker by again selecting {BLOCK, Set marker} or
  4439. {BLOCK, Set column marker}.  After setting the second block marker,  the
  4440. status  line  will display "BLOCK" and moving the cursor will not affect
  4441. the highlighted block.  All block operations are now available. 
  4442.  
  4443. You can also use the mouse to mark and highlight a block of text. 
  4444.  
  4445. NOTES:  The  "normal"  VEDIT Jr. keyboard  layout  assigns  <F9>  as   a
  4446.         "hot-key" for {BLOCK, Set marker}.  If your layout does not have
  4447.         an  assignment  for  this  function, you can alternatively press
  4448.         [BLOCK COPY]  even  if  you  do  not  want  to  copy  a   block.
  4449.         [BLOCK COPY]  also  sets  the  block markers -- until both block
  4450.         markers are set, it only sets the block markers; when both block
  4451.  
  4452.  
  4453.                                    73
  4454.  
  4455.  
  4456. VEDIT Jr.                      Chapter 4                   Editing Guide
  4457.  
  4458.  
  4459.         markers are set, it copies  the  block  to  the  current  cursor
  4460.         position. 
  4461.  
  4462.         To  remove  the  block  markers  it is usually simplest to press
  4463.         [CANCEL] (<Ctrl-C>). 
  4464.  
  4465.  
  4466. What Exactly Does the Block Include? 
  4467. ------------------------------------
  4468.  
  4469. For "character" blocks you must mark the  end  of  the  block  with  the
  4470. cursor  one  character  PAST  the  last  character to be included in the
  4471. block.  In other words, the character just before the cursor is the last
  4472. character included in the block. 
  4473.  
  4474. Therefore, if you end a "character" block at the  end  of  a  line,  the
  4475. (invisible)  "newline"  character  will  not  be included.  On the other
  4476. hand, if you end the block at  the  beginning  of  the  next  line,  the
  4477. preceding "newline" character will be included. 
  4478.  
  4479. This  exclusion  of  the  character  at the cursor position may not make
  4480. sense at first, but once  you  are  used  to  it,  it  simplifies  block
  4481. operations. 
  4482.  
  4483. Although  VEDIT Jr. displays  the  "cursor"  on top of characters, it is
  4484. best to think of  the  cursor  as  being  between  characters.   Indeed,
  4485. "graphics  mode"  word  processors such as Microsoft Word (tm) and Xerox
  4486. Ventura  Publisher  (tm)  display  the  "cursor"   between   characters.
  4487. However,  because  this  is  not  possible  in "text mode", VEDIT Jr. is
  4488. forced to display the cursor on top of the next character. 
  4489.  
  4490. If you think of the cursor as really being between characters, you  will
  4491. understand why VEDIT Jr. marks the ends of blocks the way it does. 
  4492.  
  4493. However,  we violate the above reasoning when marking "columnar" blocks.
  4494. It is much more intuitive and useful to include  the  character  at  the
  4495. cursor position when marking the end of a columnar block. 
  4496.  
  4497.  
  4498. Copying / Moving Text Within Your File
  4499. --------------------------------------
  4500.  
  4501. The  description  for  {BLOCK,  Copy  to  cursor}  in  Chapter  6  (Menu
  4502. Reference) describes in detail how to copy a block of text  within  your
  4503. file. 
  4504.  
  4505. In  short,  first  select the block of text to be copied by setting both
  4506. block markers.  Next move the cursor to the  position  where  you  would
  4507. like  the  same  text.   Then  select  {BLOCK,  Copy to cursor} or press
  4508. [BLOCK COPY] (<Ctrl-F9>).  Alternatively, to move the block, i.e.  "cut"
  4509. it  from  its  original  position  and "paste" it into the new position,
  4510. select {BLOCK, Move to cursor} or press [BLOCK MOVE] (<Alt-F9>). 
  4511.  
  4512.  
  4513.  
  4514.                                    74
  4515.  
  4516.  
  4517. VEDIT Jr.                      Chapter 4                   Editing Guide
  4518.  
  4519.  
  4520. Copying a block of text to two or more  places  in  your  file  or  into
  4521. another file is best done with the use of a "text register". 
  4522.  
  4523.  
  4524. [BLOCK COPY] and [BLOCK MOVE]
  4525. -----------------------------
  4526.  
  4527. [BLOCK COPY]  and  [BLOCK MOVE] are "smart" edit functions that give you
  4528. additional  flexibility  in  setting  block  markers.   Their  operation
  4529. depends upon how many block markers are set -- see the table below.  The
  4530. best way to understand their action is to try them in each situation. 
  4531.  
  4532. For  example,  when no block markers are set, pressing [BLOCK COPY] sets
  4533. the first block marker; pressing it again (after moving the cursor) sets
  4534. the second block marker; pressing it a third time copies the highlighted
  4535. block to the current cursor position.  In this way, only a single key is
  4536. needed to copy a block of text. 
  4537.  
  4538.                       Block Function Key Behavior
  4539.  
  4540. Function Key No Marker Set   1st Marker Set  2nd Marker Set
  4541. ══════════════════════════════════════════════════════════════════════
  4542. [BLOCK COPY] <Ctrl-F9> Set 1st Marker  Set 2nd Marker  Copy to cursor
  4543. [BLOCK MOVE] <Alt-F9>  Set 1st Marker  Set 2nd Marker  Move to cursor
  4544.  
  4545. Notes:
  4546.  
  4547.     The "normal" VEDIT Jr. keyboard layout assigns <F9> to  {BLOCK,  Set
  4548.     marker}.  Alternatively you could assign <F9> to [BLOCK COPY].  <F9>
  4549.     would then perform a convenient combination of setting block markers
  4550.     and copying a block of text. 
  4551.  
  4552.  
  4553. The Text Register
  4554. -----------------
  4555.  
  4556. VEDIT Jr. provides a text holding area called a "text register" which is
  4557. similar  to the "scratchpad" in other editors.  You can use the register
  4558. to store text independently of the text you're editing. 
  4559.  
  4560. To copy a block of text into the text register, highlight the  block  of
  4561. text  and  select  {BLOCK,  Copy  to  register}  or  press  [T-REG COPY]
  4562. (<Grey+>).  Alternatively, to also remove the highlighted block from the
  4563. file, select {BLOCK, Move to register} or press [T-REG MOVE] (<Grey->). 
  4564.  
  4565. The status line message "TEXT" now indicates that something is stored in
  4566. the text register. 
  4567.  
  4568. You can insert the contents of the text register anywhere in  your  file
  4569. or in another file.  Place the cursor at the desired location and select
  4570. {BLOCK, Insert register} or press [T-REG INSERT] (<Grey*>). 
  4571.  
  4572. The contents of the text register are lost when you exit VEDIT Jr. 
  4573.  
  4574.  
  4575.                                    75
  4576.  
  4577.  
  4578. VEDIT Jr.                      Chapter 4                   Editing Guide
  4579.  
  4580.  
  4581. Columnar Blocks
  4582. ---------------
  4583.  
  4584. VEDIT Jr. can  manipulate  columns  of  text.   A  "columnar block" is a
  4585. rectangle of characters in the middle of your text.  It can be  anywhere
  4586. from  1  character  wide to the full width of the text being edited.  It
  4587. can also extend from as little as one line  to  many  pages  in  length.
  4588. Once you have marked (highlighted) a columnar block, you can perform any
  4589. of  VEDIT Jr.'s  block  operations  on  it.   You  can  also  restrict a
  4590. search/replace operation to the columnar block. 
  4591.  
  4592. Columnar blocks are especially convenient for editing tabular data.  For
  4593. example, you could copy a particular table of numbers, say between lines
  4594. 10 and 20 and between columns 30 and 40 to the text register.  You could
  4595. then insert this table next to another table of numbers,  say  beginning
  4596. on line 50 and column 60. 
  4597.  
  4598. To  make  columnar  block  operations  appear  as  natural  as possible,
  4599. VEDIT Jr. performs some additional manipulations on your  text.   First,
  4600. it  assumes that a columnar block being copied should have a flush right
  4601. margin.  Since some lines being copied may be too  short  to  reach  the
  4602. block's  right  margin, the copy of these lines is padded with spaces to
  4603. make it flush.  This insures that when the columnar block  is  inserted,
  4604. it  does  not  destroy  the alignment of the following text.  Similarly,
  4605. when inserting a columnar block, spaces are  added  to  pad  short  text
  4606. lines  which do not reach the insertion column.  This keeps the inserted
  4607. text aligned. 
  4608.  
  4609. In some cases, such as inserting a columnar block at  the  end  of  text
  4610. lines,  these  extra  spaces become trailing spaces which are not needed
  4611. for alignment purposes.  You can select with  {CONFIG,  Emulation,  Trim
  4612. spaces  after  columnar  block insert} whether these trailing spaces are
  4613. trimmed from the text. 
  4614.  
  4615. Second, if the columnar block  being  copied  contains  Tab  characters,
  4616. these  tabs  are  converted  to spaces.  (This is essential for columnar
  4617. operations to work as expected.) When the columnar  block  is  inserted,
  4618. you  can  select  with  {CONFIG,  Emulation,  Retab after columnar block
  4619. insert} whether these spaces (and adjacent spaces in the existing  text)
  4620. are converted back to Tab characters. 
  4621.  
  4622. NOTE:   This  trimming  and  tab/space  conversion  applies  only to the
  4623.         inserted text and adjacent  spaces.   It  DOES  NOT  affect  the
  4624.         entire file and only applies in COLUMN mode. 
  4625.  
  4626.  
  4627. Columnar Block Examples
  4628. -----------------------
  4629.  
  4630. To perform columnar block operations mark the desired block with {BLOCK,
  4631. Set  column  marker}  (<Ctrl-N>).  After setting the first block marker,
  4632. the highlighting shows precisely which characters are  included  in  the
  4633. block.  You should immediately notice the difference in the way the text
  4634.  
  4635.  
  4636.                                    76
  4637.  
  4638.  
  4639. VEDIT Jr.                      Chapter 4                   Editing Guide
  4640.  
  4641.  
  4642. is highlighted in Column Mode. 
  4643.  
  4644. NOTE:   When columnar markers are set, [CURSOR RIGHT] will move past the
  4645.         end of short lines (similar to cursor positioning mode 4).  This
  4646.         lets you set the right column past short lines. 
  4647.  
  4648. The  following screen shows a columnar block highlighted.  Note that the
  4649. cursor is in the lower right corner of  the  block.   (Unlike  character
  4650. blocks, columnar blocks include the character at the cursor position.)
  4651.  
  4652.   SAMPLE.TXT      LINE:    7   COL:  22          1-END  INS            F1=HELP
  4653. ╒════════════════════════════════════════════════════════════════════════════╕
  4654. │7777777777777777777777777777                                                │
  4655. │77777777777700000000077777                                                  │
  4656. │777777777777000000000777                                                    │
  4657. │7777777777770000000007                                                      │
  4658. │77777777777700000000                                                        │
  4659. │777777777777000000                                                          │
  4660. │7777777777770000    ▓                                                       │
  4661. │77777777777777                                                              │
  4662. │                                                                            │
  4663. ╘════════════════════════════════════════════════════════════════════════════╛
  4664.  
  4665. After copying this block to the text register, the register will contain:
  4666.  
  4667.  000000000
  4668.  000000000
  4669.  000000000
  4670.  00000000.
  4671.  000000..
  4672.  0000...
  4673.  
  4674.  
  4675. The  "."  are spaces which the columnar block copy added to the register
  4676. in order to give it a flush right margin. 
  4677.  
  4678. Now consider the following text before inserting this register. 
  4679.  
  4680.   SAMPLE.TXT      LINE:    2   COL:   9                 INS            F1=HELP
  4681. ╒════════════════════════════════════════════════════════════════════════════╕
  4682. │rrrrrrrrssssssssssssssssss                                                  │
  4683. │rrrrrrrr▓sssssssssssssssss                                                  │
  4684. │rrrrrrrrssssssssssssssssss                                                  │
  4685. │rrrrrrrrssssssssssssssssss                                                  │
  4686. │rrrrrrrrssssssssssssssssss                                                  │
  4687. │rrrrrrrrssssssssssssssssss                                                  │
  4688. │rrrrrrrrssssssssssssssssss                                                  │
  4689. │rrrrrrrrssssssssssssssssss                                                  │
  4690. │                                                                            │
  4691. ╘════════════════════════════════════════════════════════════════════════════╛
  4692.  
  4693. After inserting the register, the screen will display:
  4694.  
  4695.  
  4696.  
  4697.                                    77
  4698.  
  4699.  
  4700. VEDIT Jr.                      Chapter 4                   Editing Guide
  4701.  
  4702.  
  4703.   SAMPLE.TXT      LINE:    7   COL:  18                 INS            F1=HELP
  4704. ╒════════════════════════════════════════════════════════════════════════════╕
  4705. │rrrrrrrrssssssssssssssssss                                                  │
  4706. │rrrrrrrr000000000ssssssssssssssssss                                         │
  4707. │rrrrrrrr000000000ssssssssssssssssss                                         │
  4708. │rrrrrrrr000000000ssssssssssssssssss                                         │
  4709. │rrrrrrrr00000000.ssssssssssssssssss                                         │
  4710. │rrrrrrrr000000...ssssssssssssssssss                                         │
  4711. │rrrrrrrr0000.....▓sssssssssssssssss                                         │
  4712. │rrrrrrrrssssssssssssssssss                                                  │
  4713. │                                                                            │
  4714. ╘════════════════════════════════════════════════════════════════════════════╛
  4715.  
  4716. This shows the importance of the added extra spaces when the  block  was
  4717. initially copied to the text register. 
  4718.  
  4719. Now consider the following text before inserting the same text register.
  4720. Note that text lines 6 and 7 do not reach the insertion column. 
  4721.  
  4722.   SAMPLE.TXT      LINE:    2   COL:  14                 INS            F1=HELP
  4723. ╒════════════════════════════════════════════════════════════════════════════╕
  4724. │rrrrrrrrrrrrrsssssssssssss                                                  │
  4725. │rrrrrrrrrrrrr▓sssssssss                                                     │
  4726. │rrrrrrrrrrrrrsssssss                                                        │
  4727. │rrrrrrrrrrrrrssss                                                           │
  4728. │rrrrrrrrrrrrrs                                                              │
  4729. │rrrrrrrrrrr                                                                 │
  4730. │rrrrrrrr                                                                    │
  4731. │rrrrr                                                                       │
  4732. │                                                                            │
  4733. ╘════════════════════════════════════════════════════════════════════════════╛
  4734.  
  4735. After inserting the same register, the screen will display:
  4736.  
  4737.   SAMPLE.TXT      LINE:    7   COL:  22                 INS            F1=HELP
  4738. ╒════════════════════════════════════════════════════════════════════════════╕
  4739. │rrrrrrrrrrrrrsssssssssssss                                                  │
  4740. │rrrrrrrrrrrrr000000000ssssssssss                                            │
  4741. │rrrrrrrrrrrrr000000000sssssss                                               │
  4742. │rrrrrrrrrrrrr000000000ssss                                                  │
  4743. │rrrrrrrrrrrrr00000000.s                                                     │
  4744. │rrrrrrrrrrr..000000...                                                      │
  4745. │rrrrrrrr.....0000.....▓                                                     │
  4746. │rrrrr                                                                       │
  4747. │                                                                            │
  4748. ╘════════════════════════════════════════════════════════════════════════════╛
  4749.  
  4750. By  padding  text  lines  6  and  7 with spaces, the inserted block also
  4751. remains aligned. 
  4752.  
  4753. Notice that the extra spaces added to the text register are now trailing
  4754. spaces on lines 6 and 7 above and  serve  no  alignment  purpose.   When
  4755. {CONFIG,  Emulation, Trim spaces after columnar block insert} is enabled
  4756.  
  4757.  
  4758.                                    78
  4759.  
  4760.  
  4761. VEDIT Jr.                      Chapter 4                   Editing Guide
  4762.  
  4763.  
  4764. (the default), these extra spaces are trimmed following the insertion. 
  4765.  
  4766. To demonstrate this trimming,  consider  the  following  text  register.
  4767. Note that it contains a blank line consisting of spaces. 
  4768.  
  4769.  000000000
  4770.  000000000
  4771.  .....
  4772.  00000000. 
  4773.  000000.. 
  4774.  0000...
  4775.  
  4776.  
  4777. Consider  the  following  text  which  contains three trailing spaces on
  4778. lines 4, 6 and 8.  (Remember that trailing spaces are  invisible  unless
  4779. you  change  {CONFIG,  Screen  display,  Newline  display  character} to
  4780. display the location of the "newline" at the end of each line.)
  4781.  
  4782.   SAMPLE.TXT      LINE:    2   COL:  14                 INS            F1=HELP
  4783. ╒════════════════════════════════════════════════════════════════════════════╕
  4784. │rrrrrrrrrrrrrsssssssssssss                                                  │
  4785. │rrrrrrrrrrrrr▓sssssssss                                                     │
  4786. │rrrrrrrrrrrrrsssssss                                                        │
  4787. │rrrrrrrrr...                                                                │
  4788. │rrrrrrrrrrrrrs                                                              │
  4789. │rrrrrrrrrrr...                                                              │
  4790. │rrrrrrrr                                                                    │
  4791. │rrrrr...                                                                    │
  4792. │                                                                            │
  4793. ╘════════════════════════════════════════════════════════════════════════════╛
  4794.  
  4795. With {CONFIG,  Emulation,  Trim  spaces  after  columnar  block  insert}
  4796. enabled, inserting the text register will change the screen to:
  4797.  
  4798.   SAMPLE.TXT      LINE:    7   COL:  18                 INS            F1=HELP
  4799. ╒════════════════════════════════════════════════════════════════════════════╕
  4800. │rrrrrrrrrrrrrsssssssssssss                                                  │
  4801. │rrrrrrrrrrrrr000000000ssssssssss                                            │
  4802. │rrrrrrrrrrrrr000000000sssssss                                               │
  4803. │rrrrrrrrr                                                                   │
  4804. │rrrrrrrrrrrrr00000000.s                                                     │
  4805. │rrrrrrrrrrr..000000                                                         │
  4806. │rrrrrrrr.....0000▓                                                          │
  4807. │rrrrr...                                                                    │
  4808. │                                                                            │
  4809. ╘════════════════════════════════════════════════════════════════════════════╛
  4810.  
  4811. The  trailing  spaces, including the existing ones on lines 4, have been
  4812. trimmed.  However, the trailing spaces on line 8, which was not involved
  4813. in the insertion, still remain. 
  4814.  
  4815. As explained earlier, Tab characters in a columnar block  operation  are
  4816. first  converted  to  spaces and can optionally be converted back to Tab
  4817.  
  4818.  
  4819.                                    79
  4820.  
  4821.  
  4822. VEDIT Jr.                      Chapter 4                   Editing Guide
  4823.  
  4824.  
  4825. characters.  However, a  single  space  is  never  converted  to  a  Tab
  4826. character.  Also, the first two spaces following a "." (period), "!" and
  4827. ":"  are  not  converted  to a Tab character.  This makes columnar block
  4828. operations more compatible with the needs of word processing. 
  4829.  
  4830. The above discussion also applies to columnar block copy/move operations
  4831. performed with [BLOCK COPY] and  [BLOCK MOVE].   These  are  implemented
  4832. with an internal text register and therefore operate identically. 
  4833.  
  4834. A  side  benefit  of this tab/space conversion is the ability to convert
  4835. all the Tab characters in  the  edit  buffer  into  spaces,  or  convert
  4836. sequence  of  spaces  into  Tab  characters.  First mark the entire edit
  4837. buffer as a columnar block; then move the block into  a  text  register.
  4838. If  you  only want spaces in the file, disable {CONFIG, Emulation, Retab
  4839. after columnar block insert} and insert the text register back  in.   If
  4840. you  want spaces converted to Tab characters, enable {CONFIG, Emulation,
  4841. Retab after columnar block insert} and insert the text register. 
  4842.  
  4843.  
  4844.                            Search and Replace
  4845.                            ------------------
  4846.  
  4847. The descriptions for {SEARCH, Search} and {SEARCH, Replace} in Chapter 6
  4848. (Menu Reference) describe in detail how to  perform  normal  search  and
  4849. replace operations.  Therefore, this discussion assumes you already know
  4850. the basics of "search strings" and "replacement strings". 
  4851.  
  4852.  
  4853. Pattern Matching
  4854. ----------------
  4855.  
  4856. Pattern  matching  makes  it  possible to search not only for particular
  4857. characters, but also for types of characters such as "any digit", or for
  4858. characters that meet  special  conditions  such  as  "occurring  at  the
  4859. beginning  of  a  line".  You could even search for any five letter word
  4860. beginning in "t" and ending in "n". 
  4861.  
  4862. These generalized searches are  performed  by  using  "pattern  matching
  4863. codes" within the search string.  Each pattern matching code consists of
  4864. the  special  character "|" followed by another character -- typically a
  4865. mnemonic letter. 
  4866.  
  4867. NOTE:   Although the mnemonic letter may be entered in  upper  or  lower
  4868.         case,  for  purposes of clarity, all examples show these letters
  4869.         in upper case. 
  4870.  
  4871. Here are a few examples of search strings using pattern matching:
  4872.  
  4873.     |D|D           Search for two consecutive digits. 
  4874.  
  4875.     |N|D|D|D|N|D   Search for next two digit number.  (It will not match
  4876.                    a three digit number.)
  4877.  
  4878.  
  4879.  
  4880.                                    80
  4881.  
  4882.  
  4883. VEDIT Jr.                      Chapter 4                   Editing Guide
  4884.  
  4885.  
  4886.     |<note         Search for the word "note" appearing at the beginning
  4887.                    of a line. 
  4888.  
  4889.     t|A|A|An       Search for any five letter word beginning in "t"  and
  4890.                    ending in "n". 
  4891.  
  4892. The following list describes all pattern matching codes:
  4893.  
  4894. |A          Match any alphabetic letter, upper or lower case. 
  4895.  
  4896. |B          Match a blank - a single Space or Tab. 
  4897.  
  4898. |C          Match  any  Control  Character  -  a character with an ASCII
  4899.             decimal value of 0 to 31. 
  4900.  
  4901. |D          Match any numeric digit - "0" through "9".  This  code  does
  4902.             not match "." or ",". 
  4903.  
  4904. |F          Match any alphanumeric character - a letter or a digit. 
  4905.  
  4906. |G          Match  any group character - {}, [], <> and ().  (Internally
  4907.             used by {GOTO, Matching ()}.)
  4908.  
  4909. |L          Match the "newline" character.  When {CONFIG, File handling,
  4910.             "Newline" character(s)} is set to  "0"  (default  for  DOS),
  4911.             this  matches  a  "Carriage-Return",  "Line-Feed"  pair as a
  4912.             single "newline" character.  Otherwise it matches  a  single
  4913.             "Line-Feed" character. 
  4914.  
  4915. |N          Match  any  character  except  the  following  character  or
  4916.             pattern code.  Use this code to exclude a certain  character
  4917.             or type of character.  For example, to search for "exam " or
  4918.             "examiner"  but  not "exams", use "exam|Ns".  Think of "|Nx"
  4919.             as "not x". 
  4920.  
  4921. |S          Match any separator - a character which is not a letter or a
  4922.             digit. 
  4923.  
  4924. |T          Match selected separators (terminators).  This is similar to
  4925.             "|S" but will only match the following characters:
  4926.  
  4927.             ; : , ' " Space Tab Carriage-Return Line-Feed
  4928.  
  4929.             This code  is  primarily  useful  for  programming  language
  4930.             constructs  where characters such as "$" and "_" may be part
  4931.             of variable names and labels. 
  4932.  
  4933. |U          Match any upper case letter. 
  4934.  
  4935. |V          Match any lower case letter. 
  4936.  
  4937. |W          Match "white space" - one or more Spaces and/or Tabs. 
  4938.  
  4939.  
  4940.  
  4941.                                    81
  4942.  
  4943.  
  4944. VEDIT Jr.                      Chapter 4                   Editing Guide
  4945.  
  4946.  
  4947. |X          Match any single character; this is  the  simple  "wildcard"
  4948.             similar to "?" in DOS filenames. 
  4949.  
  4950. |0          Match the "Null" character (ASCII 0). 
  4951.  
  4952. |<          Match  the  beginning  of  a  line  -- the following matched
  4953.             characters must occur at the beginning of a line. 
  4954.  
  4955. |>          Match the end of a line -- the following matched  characters
  4956.             must occur at the end of a line. 
  4957.  
  4958. ||          Match  the  "|"  character.   Since  "|"  starts  a  pattern
  4959.             matching code, you need two together to search for a  single
  4960.             "|" in your text. 
  4961.  
  4962. Most pattern matching codes match a single character; however, some will
  4963. match  zero,  one or even many characters.  The code "|W" matches "white
  4964. space" -- one or more spaces and/or Tab characters.  For example, search
  4965. and replacement strings to replace all white space at the beginning of a
  4966. line with a single Tab character are:
  4967.  
  4968.      Search?  |<|W
  4969.      Replace with?  <Tab>
  4970.  
  4971. The codes "|<" and "|>" match zero characters; they only ensure that the
  4972. entire search string matches at  the  beginning  or  end  of  the  line,
  4973. respectively. 
  4974.  
  4975. Remember when using the [REPLACE] function that ALL text characters that
  4976. are  matched by the search string are replaced by the new text.  This is
  4977. where the difference between "|<" and "|L"  is  important  text  matched
  4978. with  "xxxx|<"  does  not  include  the  "newline" character, while text
  4979. matched with "xxxx|L" does include the "newline". 
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.                                    82
  5003.  
  5004.  
  5005. VEDIT Jr.                      Chapter 4                   Editing Guide
  5006.  
  5007.  
  5008.                        Word Processing Functions
  5009.                        -------------------------
  5010.  
  5011. In addition to its wide range of features for general  purpose  editing,
  5012. VEDIT Jr. has   features  specifically  designed  to  assist  with  word
  5013. processing.  These include:
  5014.  
  5015. Left Margin for     When a left margin is  set,  VEDIT Jr.  indents  new 
  5016. Indented Text       lines  of  text  by  automatically  adding  tabs and 
  5017.                     spaces (or just spaces) to reach  the  left  margin.
  5018.                     Existing paragraphs and arbitrary blocks of text can 
  5019.                     also be indented.
  5020.  
  5021. Right Margin and    Setting  a  right  margin  also  enables "word wrap" 
  5022. Word Wrap           words  which  would  exceed  the  right  margin  are 
  5023.                     instead "wrapped" to the next line without  breaking 
  5024.                     the  word  in half.  VEDIT Jr. performs word wrap by 
  5025.                     inserting a normal "newline"  character  before  the 
  5026.                     wrapped word just as if you had pressed <Enter>.
  5027.  
  5028. Paragraph           If  desired,  each paragraph can have different left 
  5029. Formatting          and right margins.   The  margins  for  an  existing 
  5030.                     paragraph can also be changed and the paragraph then 
  5031.                     "re-formatted" to fit the new margins.
  5032.  
  5033. Justification       When paragraphs are formatted, they  can  optionally
  5034.                     also   be   justified.    Justification  produces  a
  5035.                     straight right edge to the  text  by  adding  spaces
  5036.                     between words on each line. 
  5037.  
  5038. Center  Line         Lines  of  text can quickly be centered between the
  5039.                     current left  and  right  margins  with  the  {EDIT,
  5040.                     Center line} function. 
  5041.  
  5042. Unlike  dedicated word processors, VEDIT Jr.'s word processing functions
  5043. never insert special  "control  codes".   Paragraphs  are  formatted  by
  5044. inserting  only  "newline"  characters  (a Carriage-Return and Line-Feed
  5045. pair).  Text is indented by using only Tab  characters  and  spaces;  if
  5046. desired only spaces can be used. 
  5047.  
  5048. This  makes  it possible to use text files formatted with VEDIT Jr. with
  5049. almost any other program.  For example, VEDIT Jr. is ideal for preparing
  5050. and editing text files using with Desktop Publishing  packages  such  as
  5051. XEROX Ventura(tm). 
  5052.  
  5053.  
  5054. Definition of "Word" and "Paragraph"
  5055. ------------------------------------
  5056.  
  5057. It  is  important  to know exactly what VEDIT Jr. considers to be a word
  5058. and a paragraph. 
  5059.  
  5060. Words are allowed to have embedded periods in  them,  as  in  "i.e.".  A
  5061.  
  5062.  
  5063.                                    83
  5064.  
  5065.  
  5066. VEDIT Jr.                      Chapter 4                   Editing Guide
  5067.  
  5068.  
  5069. comma  ","  always  ends  a word, even if the comma is not followed by a
  5070. space.  As a  special  case,  numbers  with  embedded  commas,  such  as
  5071. "10,000"  are  treated  as  one  word.   Of  course spaces, tabs ("white
  5072. space") and "newlines"  separate  words  from  each  other.   All  other
  5073. characters are allowed in words. 
  5074.  
  5075. To  VEDIT Jr.,  a  paragraph  is  separated  from preceding or following
  5076. paragraphs by at least one blank line or a line which starts with a  "."
  5077. "!"  or  "@"  in the first column.  Lines starting with these characters
  5078. are assumed to be "print formatting  commands"  for  programs  like  our
  5079. V-PRINT.   Print  formatter command lines are not considered part of any
  5080. paragraph and are therefore never re-formatted. 
  5081.  
  5082.  
  5083. Indenting Text (Left Margin)
  5084. ----------------------------
  5085.  
  5086. There are several ways to indent text so that it does not begin  in  the
  5087. first  column.  You can, of course, type spaces at the beginning of each
  5088. line to be indented.  This is the normal way of indenting the first line
  5089. of a new paragraph.  However, VEDIT Jr. can indent each new line of text
  5090. for you, automatically.  This is useful in word processing for indenting
  5091. entire paragraphs,  and  for  editing  programs  written  in  structured
  5092. languages such as C, Pascal and PL/I. 
  5093.  
  5094. The  left  margin  determines  how  much  newly  entered  lines  will be
  5095. indented.  Normally the left  margin  is  set  to  column  1.   Pressing
  5096. [INDENT]  (<F8>)  increases  the left margin and [UNDENT] (<F7>) reduces
  5097. the left margin.  These functions change the left margin by the  "indent
  5098. increment", which is normally "4", but configurable. 
  5099.  
  5100. The  left margin can also be changed with {CONFIG, Word processing, Left
  5101. margin}. 
  5102.  
  5103. VEDIT Jr. indents text by  padding  the  beginning  of  lines  with  Tab
  5104. characters  and  spaces.   The optimum number of tabs and spaces will be
  5105. used and depends upon the currently set tab stops.  If you  prefer  text
  5106. to  be  indented using only spaces, set {CONFIG, Emulation, Expand <Tab>
  5107. key with spaces} to "Yes". 
  5108.  
  5109. VEDIT Jr. has another mode of indentation called "auto-indent".   It  is
  5110. primarily  intended for editing structured programming languages such as
  5111. "C".  In auto-indent mode, each new  line  will  be  indented  the  same
  5112. amount  as  the previous text line.  You can then change the indentation
  5113. of the new line by pressing [INDENT] or [UNDENT] to start or end a block
  5114. of program instructions.  The main advantage of auto-indent mode is that
  5115. you can jump around in a program and  newly  entered  instructions  will
  5116. automatically fit the indentation of the current block of instructions. 
  5117.  
  5118. Auto-indent  and  the  "indent increment" are configurable with {CONFIG,
  5119. Programming,  Auto-indent  mode}  and   {CONFIG,   Programming,   Indent
  5120. increment}. 
  5121.  
  5122.  
  5123.  
  5124.                                    84
  5125.  
  5126.  
  5127. VEDIT Jr.                      Chapter 4                   Editing Guide
  5128.  
  5129.  
  5130. HINTS   Do not not indent your text to keep it from printing on the left
  5131.         edge  of  the paper.  The print functions let you set a separate
  5132.         "printer margin" for this purpose. 
  5133.  
  5134.         [INDENT] is not designed for  indenting  the  first  line  of  a
  5135.         paragraph.  Spaces should be used for that purpose. 
  5136.  
  5137.  
  5138. Word Wrap (Right Margin)
  5139. ------------------------
  5140.  
  5141. Setting  the right margin enables "word wrap" which automatically starts
  5142. a new line when text reaches the right margin.  The entire  word,  which
  5143. would  otherwise  exceed  the  right margin, is wrapped to the next line
  5144. without breaking the word in half.  The  new  line  will  start  at  the
  5145. current left margin. 
  5146.  
  5147. Ordinarily,  the  right  margin is disabled.  To enable it, use {CONFIG,
  5148. Word processing, Right margin}.  The right margin is the last column  in
  5149. which  a  displayable  character can occur.  However, spaces, especially
  5150. the typical two spaces following a sentence, are allowed to exceed  this
  5151. margin. 
  5152.  
  5153. A value of zero turns the right margin off, disabling both word wrap and
  5154. the {EDIT, Format paragraph} function. 
  5155.  
  5156. The  right  margin  can be greater than the screen line length, in which
  5157. case VEDIT Jr. will either scroll the screen horizontally or  display  a
  5158. continuation line before the word wrap takes place. 
  5159.  
  5160. As  you  edit  a paragraph, existing text will sometimes extend past the
  5161. right margin.  This is normal, because word wrap only  occurs  when  new
  5162. text  is  entered  past the right margin.  You can get all the text back
  5163. between the margins by reformatting the paragraph. 
  5164.  
  5165. IMPORTANT NOTES:  The right margin should be  turned  off  when  editing
  5166.                   programs;  otherwise,  accidentally  selecting  {EDIT,
  5167.                   Format  paragraph}  will   generally   scramble   your
  5168.                   program.   VEDIT's  "undo"  usually cannot recover the
  5169.                   text in this case. 
  5170.  
  5171.                   Do not confuse the right margin with  the  "Horizontal
  5172.                   Scroll  Margin"  --  the latter only controls how long
  5173.                   lines are displayed on the screen. 
  5174.  
  5175.  
  5176. Formatting and Justifying Paragraphs
  5177. ------------------------------------
  5178.  
  5179. VEDIT Jr. can "format" a paragraph to fit it between  the  current  left
  5180. and  right  margins.   To  do this, VEDIT Jr. may move one or more words
  5181. from the end of a line to the beginning of the next line or borrow words
  5182. from the beginning of the following line to fill out  a  line.   In  the
  5183.  
  5184.  
  5185.                                    85
  5186.  
  5187.  
  5188. VEDIT Jr.                      Chapter 4                   Editing Guide
  5189.  
  5190.  
  5191. process, the number of lines in the paragraph may change.  VEDIT Jr. can
  5192. optionally  add extra spaces between words to "justify" (straighten) the
  5193. right edge of the paragraph. 
  5194.  
  5195. The paragraph will be formatted to fit  between  the  current  left  and
  5196. right  margins.  For example, if a paragraph is indented 8 spaces before
  5197. formatting and the left margin is currently 4, formatting the  paragraph
  5198. will result in it being indented only 4 characters. 
  5199.  
  5200. To  format a paragraph, first ensure that the left and right margins are
  5201. set as desired, place the cursor anywhere in the  paragraph  and  select
  5202. {EDIT,  Format  paragraph}  (<Ctrl-F>).  After formatting, the cursor is
  5203. advanced to the beginning of the next paragraph so that you  can  easily
  5204. format several consecutive paragraphs. 
  5205.  
  5206. After  formatting  a  paragraph  or using word wrap, you may notice that
  5207. each text line ends in a space.  This actually is the  space  you  typed
  5208. between  the words.  Lines ending in a period "." are typically followed
  5209. by two spaces.  These spaces at the end of a line are allowed to  exceed
  5210. the right margin. 
  5211.  
  5212. When formatting paragraphs, VEDIT Jr. attempts to maintain double spaces
  5213. between sentences, i.e. after ".", "!" and "?". 
  5214.  
  5215. NOTE:   An  indented  line  is not enough to separate one paragraph from
  5216.         another; blank  lines  MUST  be  used  to  separate  paragraphs.
  5217.         Otherwise,   re-formatting   paragraphs   will  combine  several
  5218.         paragraphs into one! 
  5219.  
  5220.  
  5221. Offset Paragraphs
  5222. -----------------
  5223.  
  5224. An "Offset Paragraph" is a special type of paragraph whose first line is
  5225. not  indented  the  same  distance  as  the  rest  of   the   paragraph.
  5226. VEDIT Jr. maintains  this  difference  in  indentation when formatting a
  5227. paragraph as in the following examples. 
  5228.  
  5229.         This is an offset paragraph.   Notice  how  the  first  line  is
  5230.     indented 4 character spaces further than the rest of the paragraph. 
  5231.  
  5232. When  this  paragraph  is reformatted with different margins, the second
  5233. line will be aligned with the left margin and the  first  line  will  be
  5234. indented the same four spaces. 
  5235.  
  5236. An  offset  paragraph  can  also  have the first line outdented from the
  5237. remainder of the paragraph. 
  5238.  
  5239.     1.   This is an offset paragraph.  Notice how the first line  is  at
  5240.          the  left  margin  while  the  remaining  lines  are indented 4
  5241.          characters. 
  5242.  
  5243. When this paragraph is reformatted with  different  margins,  the  first
  5244.  
  5245.  
  5246.                                    86
  5247.  
  5248.  
  5249. VEDIT Jr.                      Chapter 4                   Editing Guide
  5250.  
  5251.  
  5252. line will be aligned with the left margin. 
  5253.  
  5254.  
  5255. Justification
  5256. -------------
  5257.  
  5258. When  "justification"  is enabled with {CONFIG, Word processing, Justify
  5259. paragraphs}, VEDIT Jr. will adjust the spacing between words to create a
  5260. straight right edge to the paragraph. 
  5261.  
  5262.     This is a justified paragraph.  Notice how  the
  5263.     spacing  is  randomly  adjusted  between  words
  5264.     to  maintain a justified right margin.  This is
  5265.     preferable in some, but not all applications.
  5266.  
  5267. If you need to edit text after it has been been justified, it is  easier
  5268. if  you  first "unjustify" the text.  This removes the additional spaces
  5269. between words, leaving the right margin  ragged.   (It  will  leave  two
  5270. spaces  following  ".",  "?"  ":"  and  "!").  To unjustify a paragraph,
  5271. change {CONFIG, Word processing, Justify paragraphs} to "2" and reformat
  5272. the paragraph. 
  5273.  
  5274. SUGGESTION:  Documents justified by another word processor should  first
  5275.              be unjustified for easier editing with VEDIT Jr. 
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.                                    87
  5308.